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From the Editor 




ft December • 2006 


I M JF elcoinc to anotlier month of Mac-ccntric teclinology! Wc’ro excilecl to be 
UMmM closing out 2006 with articles that truly showcase the elegance of OS X, 
mm mm John Welch is back with a great tip on rolling out Microsoft Office 
W m updates to an office full of Macs, When you have a handful of Macs, 
updating each machine in turn isn’t a problem - but when that number 
climbs, you need ttJ automate, Let John show you how'! 

Jose Cru?, brings an article that coni]}limcnts John’s; all about Package Maker. 
This article show's you eveiything you need to know about creating install packages 
for any use. 

Another returning author, MUiaUs Tsoukalos goes in depth writing a Dashbtxird 
Widget plug-in. While Widgets are veiy capable on their own, they arc even more so 
when extended via Objective-C. 

Atitiior Paul Ammann again brings us two articles: a follow-up to liLs “Intro to 
XSan”, plus something that goes right to tlie core of my lieart: sorting using shell tools, 
primarily awk and sort. 

Ben Waldie's AppleScript Essentials and my Mac In The Shell columns feature 
even more ways to get the most out of your Mac, But don’t let that make anyone forget 
about our product guide! *7'i,s the season to make purchases; for others, and yourself! 
This month’s MacTech helps guide you to the best technology purchases available, 

1 hope everyone has made tlieir plans for MacWorld. There's probably a little time 
left if you haven’t. MacTech will have a booth once again, and many MacTech authors 
will be attending the show. We hope to see you there. 

Happy holidays and Happy New Year! We hope to .see you in person in January, 
and then will see eveiynnc all of 2007 in print! 


- Edward Marezak, Executive Editor 
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AppleScript Essentials 


by Benjamin S. Wo Idle 

AppleScript 

Code 

Libraries 

___ / 

If you liavu Ixx^n R.'iiding my ccMiimiis for a while (prior to my 
intioductory series on scripting dil'lerent applications), ilicn you may 
know that 1 am soniewliat of a subroutine bindler faruitic. 1 fed that 
liandlcrs arc an exircmdy importani part of AppleScript 
develo[Dinent, aixl dial every AppleScripter sliould be using them 
quite often, Unfoitunately, many AppleScript develo[iei:s do nca. 

There arc many lx.^nenis to using handlers in a sc'ript. Let’s 
discuss a few of tlic-se brielly, Handleis prcjvide a mtx^hanisni for 
modularizing AppleScript code into generic cburiks, which can Ixr 
called from multiple l(x::ition.s within a script, 'HiLs am lead to more 
clTicienL script writing, lasLead of spending lime writing virtually the 
s^tme code over and over again thn)ughout a you can instead 
ftK'us mom time on waiting a solid and reliaf^le kindler, which can 
Ix:^ called numerous times lliroughout the script. Non only does tliJs 
help to cut down on the loial atiKJuru of code you netd to write in 
a script, but it also helps to provide a more focused completed 
script, I?ecnuse mulliple sections of the script aill tlie s^m\e liandler 
code, there are typically fewer areas lo inxibleshtK)! if prol)lems do 
cxxtir during exeaition. Fuitliennore, if written modtilariy enough, 
ii may even possible to extma a liandler Ifom a script, and plug 
it into other scripts, ixitentially Rdiidng sciifit writing lime in the 
hiuire tcK). Ihls leads me into tlie main focus of tliis iiiontlVs cxjlumn, 
AppleSc ript cede libmries. 

What is an AppleScript Code libraiy 

What exaclly is an AppleScript code lil^raiy? An AppleScript 
code libraiy, aka a script library, is an AppleScript file thai 
contains pieces of code, usually handlers, which may be loaded 
and accessed by another script during its execution. AppleScript 
code libraries provide an excellent w^ay to organize generic 
chunks of code, to be called by one or more scripts. 

For example, suppose ymi often write scripts tlaat autom.ate 
tasks in QuarkXPrL*ss. Tlie tdds are pnsbably pmty gcxxi that many 
of these scripts will perform similar tasks, and many may use similar 
or identical ttxie. If ihts were the case^ it would make sense to write 
much of your Quark c:(de as generic handlers, which can then be 
merged together into a single saipt file to fomi a script library. Tins 


library of Quark liandlers could tlien saved into a central location, 
and then loaded by other scripts in the future, which cm then c'all 
its liandlers as needed. 

Building a Script Library 

Building a script library is really as straiglitforward as 
creating any AppleScript file. Ibere aren’t realty any hardcore 
requirements. A serif )t I library will often contain handlers, but it 
doesn’t need to. It can contain any thing that any other script 
can c'ontain, including properties, globals, a nm handler, etc. A 
.script Irlmary can even load other script libraries. 

Preparing to Follow Along 

The example code that we will explore throughout this 
montli's column will involve calling code wiiliin a script liiirary 
file, 'lb follow along with these examples, you ll need to create 
a script library file. Begin by creating a new Script Editor 
document, and enlering the following code, 

property soinGProperty : "^Property Value” 
display dialog ■‘Running...” 
on someHandierO 

display dialog “Handler exaciiting.. 
end someHandler 

on d IspIayPropetiy(J 

display dialog someProperty 
end dlsplayProperty 

As you can sex;, this code [hat will niake up our .script library 
contains a plDpe^t>^ some run handler cxxle, and .some subroutine 
handlers. We will walk through the process of accessing each of 
[hese elcTiienls In our script library from within another script. 
Next, we need to save our script libmiy. To do this, just 
save the Script Editor document as a compiled script to your 
desktop, and name it My Ubrarysc/jt^ 

Loading a Script Library 

Now that we have created our script lit^raiy, we are ready to 
begin accessing it from another script, lb do this, we will make 
iLse of a command that is included in the Scripting Commamls 
suite of the Standard Additions scripting addition, callcxi load 
script, 'llie load script command acc'epts one direct 
j:>arameter, a reference to n script file to be loaded. For example: 

set theLibraryPath to alias [(path xo desktop folder as 
atcing) £i “Hy Library .sept”) 
load script theLibraryPath 
-> «script» 

If you iiin the above example code, you w ill find that, in 
Script Editor’s result pane, the result of die load script 
command is a reference to live newly loaded .script library. Like 
any other result, diis reference may be placed into a variable, for 
later reference throughout your script. For example; 

set theLoadedScript to load script theLibraryPath 
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Types of Scripts that May Be Loaded 

Momentarily, we will explore whai yau can tli? once ytwj 
have loacieil a M*npt library file. However, 1 (ifSi want to mention 
ihe tyf>e.s of script library files that may lie loaded. The load 
script command may be used to Ifxid axnpiled serifH files, 
scTipt applirations, script bundles, and script appliaition hiindfes. 
It may nt>i lx? used to load scripts thiit have been saved in text 
fonnac. Also, if you are using an older version of Mac OS X (pre- 
10.3.x), Uien you will not be able to load scrifit bundles or script 
application bundles. Tlie ability to load these types of scripts was 
not possible prior to AppleScript version 1S).2 in Mac OS X 10.3. 

Running a Script Library 

So, now that we have loaded a sc:ript lil)njry file, what do we 
do with iP One thing that we can do with it Is njn it. 'lliis t^an be 
done by .simply telling the loaded script to run. For example: 

set tbettbrarypath to alias ((path to desktop folder as 
string) (t "My Library .sept**} 

set theLoadedScrlpt to load script thsLibraryPath 
tell theLoadedScript to run 
I button returned:'‘OK** I 

ff you lest lliis example code, then you will find that telling 
the loaded script to mn wih result in the exmirkm of any code 
located within the loaded script's run liandler. See figure 1. 


Running,,, 



C Cancel J ^OK-^ 


Figure L Running a Loaded Script Library 


You will also llnd that, if the run handler of the loaded 
.script produces a result, then that result will l>e passed back to 
the loading script as the result of the run command. 

Them arc aaually .several syntaaicil variatioas to ainning a 
loaded scrifit. Another way is to use the run comiiLincl, fcillowal by 
a reference to the loaded script as a dimt1 pammeter. For exaiii[>ie: 

run thoLoadiidScrlpt 

Yet :tnotlier way to nm a loaded sciijx is to iiiake use d' tlie run 
script ctMTirnand, whkii is also fouixJ in die Scriptmg Conmimids 
suite in die J^tandaid Addidtxis aripting addition. 'Hus amiTtimi Ls also 
followed by a refenenc’e ia tlie loaded script its diietl [Xirameter. 

run script theLoadedScript 

When using the run script command, ids also m>t 
actually neccnssary to lt)ad the st'ripl prior to running it. The run 
script command itself may lie passed the path to a script file 
as its direct parameter, 'fhis will cause the si'ripi file to Ik* 
loaded and run, all in one shot, as demonstrated liere: 


ruu script tbeLlbraryPath 

Calling Handlers within 
a Script Library 

While nmning a liraded sc'ripi is great, and can sometimes 
fx: very useful, tlie real power conies with the ability' to trigger 
handlers within loaded script libraries. Once a script has Ix^en 
loaded, imy of its handlers are at your disfxxsai, and may be 
called as needed, througliout the loading script. 

Handlers in a loaded script are called much in Lite same 
way that local handlers are called within a script. Unlike local 
handleiTi, however, tliey must just Ixf directed to the loaded 
.script. Often, this is done through the use of a simple tell 
statement. In other words, the loading scripl tells the loaded 
script to execute a specific Imndler Ftir example: 

set theLibraryPath Ip alias ((path to desktop folder as 
string) & “My Library*scpt") 

set tbeLoadedScript to load script theLibraryPath 
tell thcloadedScript to someHandler() 

-> fbutton returned:"OK"I 

If you nm the previous example ctxle, you will find that the 
someHandler 0 handler within the loaded script is executed, 
as indicated by the dialog the handler dispbiys. See figure 2. 


Handler executing,.. 

Cancel 3 ^ 


Figure 2. Calling a Handler in a Loaded Script Library 

As an altemaLive to using a tell statement to call a handler 
wiihin a loaded script, another equally acceptable metlxxl is the 
follow'ing, which will fx^rform in exactly the same manner as the 
previous example. 

soinf^HBndler () of tbeLoadedScript 

Accessing Properties within a 
Script Library 

Referencing Properties in a Script Library 

As one might exjieti, if a loaded script contains properties, 
then those propenies may Ix^ actessetl by any ctxle, such as 
handlers, within the loaded script. For example, here is some 
exampie ctxle that will execute a handler within our loaded 
script This handler will display the value of a property in tlie 
loaded script. See figure 3- 

sfit theLibraryPath to ullaB ((path to desktop folder as 
string) & “Hy Library.sept") 

set theLoadedScript to load script theLibraryPath 
tell theLoadedScript to displayProperty() 
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Figure y Calling a Handler in a Loaded Script to Display a 
Property Value 

PixijxMtius witliin a loaded ,scripl may also lx* acres.scd by Lite 
loading script, lliis is done similarly Lo die pixxe,s.s of calling liandlers 
in a loaded script from wiiliin Lite Imding script, Tor example' 


Ntiw, to deiinjiistrate that die modilied property^ value is not 
retained betwc'en loads, try running the previous exainf^le code 
a second time. When you do this, ytju will find that the first time 
the displayProperty () handler is emailed, it displays the 
original unmtxiified value for property some Property. 

Storing a Modified Script Library 

However, it is actually possible to retain a modified 
property value within a loaded st:ript. To do this, the loaded 
.script must lx: stored back into itself after the property' has Ixren 
modified, This is done using the store script coimmind, 
which is found in the Sen/Hin^ Commamls suite in the Standard 
Adtlitions scripting addition. For example: 


set iKeLibraryPath to ellas ((path to desktop folder as 
string) & Library * sept**3 

set theLoadedSoript to load Bccipt theLibraryPath 
some?roperty of theLoadedScrlpt 
"Property Value" 

MiKlifying Properties in a Script library 

As you ntiy blow, when utilized in a script applit^ation, 
profX'rties are persistent lietween executions of the script. In other 
words, if you modify the value of a property williin a scri|X 
appliaition, then the nuxlified pioperty value will be retained until 
ilic pn)pcrty is modified again, or until the script Is Rx-ompikxl 
Upon a recompile, the property will revert to its original value. 

Properties in Icxidt'd scripts are handled slightly difteieiilly. If 
y<su nuxlify a pnj|xity in a loaded setipt, the moditkxl pn^jx^rry 
value will lx retained as long as the script remains loaded. 
However, the next time the script is lixtded, ii will revert back to its 
original value. Ttie mtxlified [)rojxrty value is not retained Ix-'iween 
loads. Tills can lx demonstrated via the following exiunple ctxle. 


set tbeLibraryPath to alias ((path to deEktop folder as 
Gtring) & "Hy Library. scpi") 

set theLoadedScript to load script iheLibraryPath 

tell theLoadedScript to displayPropertyO 

set soneProperty of theLoadedScript to "New Property Value" 

store script theLoadedScript 

In ilie examfde code ulxive, notice tli;it, w'iiile we liave specified 
the kxtded script to lx stored, we have not spcxifietl where it should 
be stored. When the store script cumrixind is used with only a 
direct parameter, llie script U> stored, you will lie ptompied to 
sfxxlfy where tlie kxided scrijX is to lx .storecL See figiire S. 


O O 0 Store Script 


Specify KrijM neme iin<| locAtlon 

Save At: irntitled 

0 

Where: [ Qocyments 

JD 
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set theLlbraryPath to alias ((path to desktop folder as 
string) h "My Library.sept") 

set theLoadedScript to load script theLlbraryPath 
tell theLoadedScript to dlspl3yProperty() 

set soiaeProperty of theLoadedScript to "Hew Property Value" 
tell theLoadedScript to dlsplayPropertyU 


If you run the example axle above, you will find that the 
displayProperty 0 handler will be called twice. Once, 
immediately after llic script has been loaded, anti ng:iin, after the 
value of the proiieriy someProperty ha.s been mexlified to a ww 
value. The first time the dl.splayProperty () tiiindler is called, 
it will display a dialog indicating the property's {)riginiil value, siiown 
pawlously in figure 3- The sea>nd time the handler is cullc'd, it will 
clisf^lay a dialog indiaiting tlie property’s new value, showing tliat 
the pnopertys value has actually lieen changed. See figure 4. 


New Property Value 

( Cancel ) 


Figure 4. Calling a Handier in a Loaded Script to Display a 
Modified Property Value 


Figure 5. Storing a Script Using a Specified Name and Location 

To store the script liiKk i(» its ori}>in;il file path, we can 
specily a file pat It for tlie store script command's optional 
in labeled panimeter. l-or example: 

Ei.ore script theLoadedScript in theLlbraryPath 

When used in this manner to stoa^ a script Ixick H) its original 
ITJth, tile store scripL command will aiiniif)! to overw'rite the 
existing script fikt Ikx'iiii.st^ at tliLs, another dialog will lie displayed, 
asking wlieilier Llie existing file should Ix" rephiaxl. See figum 6. 


Overwrite existing Script Filt? 


Save As.,, ^ ( No ) C ) 


Figure 6. Storing a Script With or Without Replacing ait 
Existing Script 

To allows the loacied .script to be stored back to its 
original path without displaying ibis dialog, we can 
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make use of another optional labeled parameter for ilie 
store script command, replacing. For example: 

store script theLoadedScript In theLlbraryPath with 
replacing 

Running lliis example ctxle will now result m our 
loaded script Ix^ing stored back to its original path, with 
no dialog being displayed. If you now load the .scripl 
again and call the displayPropertyC) handler, you 
will find that the new property value has been retained. 
The modified property value will continue he retained 
until it is modified again, or until the script 1 library file is 
opened and recompiled. 


within the running script library. Also, weVe 
discussed accessing properties in loaded scripts. For 
extra credit, try also expk^ring how globals work in 
Itjaded libraries. Can globals be shared between the 
loading script and the loaded script? Perform some 
tests on your own i,o find out. 

Until next dme, keep scripting! 


\\\{ 


In Closing 


About The Author 


Hopefully, youTe starting to see the benefits of 
using script libraries, especially for sharing subroutine 
handlers among multiple scripts. The example code 
ihrouglumi this column should provide you with a 
good foundation for staiting to create and access your 
own libraries. Once you feel comfortalde using the 
techniques that we have discussed, you may want to 
consider exploring some other interesting ways of 
utiliJiing script til>raries. 

'fry saving a script library as a stay opened 
application and prc-launching it to reduce loading 
lime. Tlien, allow multiple scripts to call the code 
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Creating a 
that 


What are Widg^}ak§mandfrom within a 


ard Widget 


Introduction 


By Mi halts Tsoukalos 


In this article, you will learn how to create Widget 
plugins by using the Objective-C programming language. In 
fact, this article will help you create the MyPht$iin Widget 
plugin that is included in a Dashboard Widget. What the 
plugin docs is to send the ‘'Hello World!" message to the 
Widget that finally prints it out. Although ihis is a simplisiic 
Widget, the pre.senied methods, procedures, and practices 
remain unchanged wlieti you want to create a more 
sophisticated Widget plugin. 

Objective-C was introduced wit ft NeXTSTEP and 
OPRNSTKP. It is mainly used in combination with the Cocoa 
framework Ca collection of librane,s) under Mac OS X, 
although you can program in Objective-C wilIujui using 
these libraries if you want to. Widget plugins are created 
using Objective-C. 

What is a Widget Plugin? 

Let us face the truth mm: Widgets alone cannot access 
applications diaictly, receive distributed nolifiattioas, or read 
files from disk without the help of the widgeUystemO call 
which is not always the preferred .solution. To enable these 
interactions, you need to provide a plugin. You are required to 
implement an interface Ibr your plugin diat makes itself 
available to the Widget. 

Advantages and Disadvantages of 
Widget Plugins 

'Ihe advantages t>f plugins include the following: 

L Your source code is hidden and more secure, 

2. NolxKiy can chinge yair Wkiget pUtgin withmii ymr penTiis.sion, 
5, You can create commercial Widgets. 


4. You can do things that simply arc not possible with 
JavaScript and the built-in Widget functioas by using the 
Coccja framework. 

Tlieir distKlvanliiges are the following: 

L It is more difficult and time con.Huming to program a plugin 
for a fttnctitjnality that is also sLipfK>ried ()y JavaScript. 

2. It is iriore difficult to debug a Widget plugin. 

3* You have to learn Objective-C. 

4. You also have to learn Cocoa. 

Which files compose the complete 
MyPlugin Widget? 

Tlic files that compfjse the MyPlugin Widget presented in 

this article are the folkjwing: 

1. Info.pli-st; the well-known file necessary' for every Widget 
that ha.s an uncommon key added. 

2. MyPlugin.litinl: the main HTML file for the '^MyPlugin'' Widget. 

.3. MyPlugin.js: the JavaScript code needed for the 

“MyPlugin” Widget. 

4. MyPIugki lu- tile Myl^liigin.m file a>nlains tlie Objective-C code. 

5. MyPIugin.h: the Myl^kigiii.li file i.s the Objective-C header file 
for MyPiugin.m. 

6 . Directory My Plugin, widget plugin: this conlaiiis the files for 
tJte Wklgc‘1 plugin that are automaticiilly cre;tted by XcxxJe, 
After you succes-sfuky build your Xc'otle piojecl, you will find 
it iaside the bt/iWwiease direaory of ymr project's directory. 

7. Iwo image files called ITefaull.png and Icon.png. Every 
Dashboard Widget has those two graphics files. I'he 
kon.png file should lx? 82x82 pixels, and is displayed in the 
Dashboard Widget Bar. 
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The Inlo.plist file 

Tile contents of the infb piist file are die following: 

versloR="l ,0" encoding-"UTF-B’?> 

<!D0CTYP£ pList PUBLIC " //Apple Coi«putEr//DTB PLIST ^OZ/EN** 
"ht t p j//www K apple * com/DTDs/P ropertyLlst * 1.0. d cd"> 

<pll3t verslon^^l^O") 

<dict> 

<key>CFBundleDisplayName</key> 

<st ringXMyPlugin</siring> 

<key>CP8undleIdentifier</key) 

^ St r i n|>c<Jtn * mac tech. widget. iiiyplugin< /st r 1 ng) 

<kcy ^CFBundleName^/key) 

<sirlng>My Widget PlugiTi</fltrlng> 
<key>CFBundleShbrtVersit>nStrlng</key> 

<string>l. iX/stcing) 

<key^CFBu,ndleVGrElonC/kcy> 

<fitring>l * K/string) 

<key>CIoseEoxInse tX</key> 

<integGr>4S</iiiteger> 

<key>ClofleBoxlnsetY</key> 

Cinteger>35</integer> 

< key > HainETML </key > 

<stiring>HyPltigiii.htiiij </srrlng> 

<key>Plugin</key> 

Cstring>MyPliigin, widget plugin</string> 

</'dict> 

</pllst> 

Tltc unusual key that I talked about previously Is the Plugm 
key. Its value is the name of the dintaory that holds t!ic Widget 
plugin files. 


The MyPlugin.html file 

The contents of the MyPlugin.htinl file are the following: 


<1- 

File: HyPlygin^html 
Progranwntfir: Mlhalis Tsoukalos 
Datn: Saturday 16 September 2006 

-> 

CkLnil) 

<head> 

<!- The CSS file for this widget -> 

<1- This Is s very simple CSS file —> 

<style type="text/css") 

^^import "MyFlugin.csfi": 

</style) 

<1- The JavaScript file fur the “HyPlugin** Widget -) 

An essential file For implementing the plugin 
functionality -) 

^script type='text/javascript* scc“’MyPlugln.js' 
charsot^'uif ttV) 

</head> 

Cl- Every tine the user clicks anywhere on the "HyPlugin" 
Widget. 

run the nextO JavaScript function 
(body one] icli='''iniext () ") 

<lmg src="Detault*png"> 

<1- Basic placeholder text —> 

Cdiv ld-"t|Uote“)Cllek here to say hello K/div) 

</body> 

</htral> 

It shtMild he noted that the MyPIugin.hUiil file ads as the 
glue that conneds all the other Widget files. 
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The MyPluginxss File 

Tlie contents of the My Plugin.css file are file following: 

/* 

File: HyPlujin^css 
Pro^raatraer: Hihalle T^oukalos 
Date; Saturday 16 September 20Q6 

*/ 

body 

t 

marglti: Ot 

I 

tquote 

I 

font: 3Sp]c "TiniBs" ; 
font-veigbt: bold: 
color; gray: 

text^shadow: white Opx Ipx Qpx: 

position: absolute: 

top; lODpx; 

left; 45px; 

width: 165px; 

opacity: 1.0; 

1 


The MyHugin.js File 

I'he MyPlugin.js file is fiic most imix)rt:int file of the whole 
Widget. A small mistake in it and the Widget will either 
niLslx'lKive or not work at alL Its 4 'ontents are llte fulkiwing: 

/* 

File; MyPlugin.js 
Programsier: Mibalis Tsoukaloa 
Date; Saturday 16 September 2006 

-/ 

//Tliis code is pan of the 
// ^ My Plugin" Dashboard W idgf t. 

// Ificfcasts the cirrrent value by one. 

// It uses the Object ive-C Widget 
// plugin to get the new value. 

function iitfapO 
i 

if {MyPlugin) 

1 

// get the next text from the Widget plugin 
var line * MyPlugin.getTcxt()i 
// drop in the new text 

decuaeut.getElemBtitByld(‘‘quote") .InnetHTML • line: 

) 

elfle 

I 

alert("Widget plugin not loaded."): 

* 

] 

// Perfomis the transition from the current 
// text to the next one using a simple effect. 

// Note: In this example both texts are the same, 
function nextC) 

I 

// fades out the current text 
hideContent t); 

// swaps in the next text 
setTimeout ("swap(): ”.500): 


// fades in the new text 
setTimeout{"showContent ():"»550 > ; 

I 


// Animation code 
// Handles the fades in and out 

■ a 441 l-J-l KV-I-I-V #'^ 

var animation = (duration; Cl» start time :0. to; 1.0, now; 1.0, 
from; 0*0, firstFlement :nuii . timer:nuni: 

function showOontent() 

I 

// reset the ammaiioii linier valuer in case a v'aluc was left beliind 
if (animation.timer !" null) 

clearlnterval (animation.timer): 
animation.timer * null: 

1 

// set it back one frame 

var start time ^ (new Date) .getTimeO - 13; 
f/ animation time, in nts 

animation.duration * SOOr 
// specify the start time 

animation,starttime * starttime; 

// specify the element to fade 
animation. firstElement “ document .get Element By Id 
('quote’): 

// set the iinimation function 

animat ion. timer ” aoi Interval ("animateO ; 13): 

animation.from “ animation.now; 

// beginning opacity (not ness. 0) 

// final opacity 

animation.to - 1.0: 

// bcghi anhnation 
animate 0: 

I 


function hideContent() 

I 

if (animation.timer null) 

{ 

clearlnterval (animation.timet): 
animatIon.timer - null: 

1 

var starttime = {new nnte).getTimeO * 13; 

animation.duration " 500; 
animation.Starttime = start time; 
animation.firstEiement “ docuiiont.gelElementById 
t■quote*}: 

animation, timer set Interval ("anlmateO ; B): 

animation.from = an!mation.now: 
animation.to = 0.0; 
animate(}; 

I 


function animate() 

I 

var T: 

var ease: 

var time = (new Date) .getTimeO : 


T = limlOCtime anlraation.starttirae. 0* 
animation.duration); 

if (T >= animation.duration) 
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I 

clearlnterval (animation.tiuer); 
ariimatiott.tittet “ null; 
animat ion. now *= animation, to: 

J 

else 

( 

ease ^ 0.5 ^ (0.5 * Math.cos(Hath. PI * T / 
animatloti.duration]); 

animat ion. now * computeNext Float Caniniat Ion .from, 
animat Ion.to, ease): 

J 

animation.firslElcment.ntyle.opacity - animation.now: 


// ihtrsc functions arc utilities used by anlmatcO 
function limit„3 (a. b, c) 

I 

return a < b ? b ; (a > c ? r ; a): 
i 

function computeNextFloat {from. to. ease] 

I 

return From 1 (to - from) * ease: 

1 

The swtipO JavaScripi function Ls the single most 
important function of the MyPIugin.js file. It first checks if the 
MyPlugin Widget plugin is available, tf it is available, it calls 
the MyPlugin.gefJ'exK) function and gees its ouipui. It then 
prints the results using the 

d<)cumcnt.getElementiiyId(''quote'’).innerH'l'MI. JavaScript 
command. 
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(treating the Widget plugin using Xcode 

A widget plugin is a Cocoa bundle. Start in Xcode, by 
using the “Cocoa Bundle" template. In the plugin code, 
implement the widget plugin interface. Build your Objective- 
C code, and you are ready to use your Widget plugin. Before 
you create the actual Widget plugin, you must first learn how 
to create Universal binaries in Xcode. Apple correctly 
suggests that you only create Widgets wilh Universal binary 
plugins. 

Creating Universal Binaries 

to make Widget plugins able to work on both PowerPC 
and Intel Macs, you have to create them as so-called 
Universal Binaries. This is easily accomplished, when using 
the latest Version of Xcode and all necessary steps are 
tlescribed here. 

The steps for creating a command line Universal l>inary' are 
;ls follows: 


1. First you have to open Xcode from /Developer/Applications 
directory. 

2. Chtxxse File (D New Prrjjecl. 

3. Select the Standard Tool option from the Command Line 
Utility project list (see Figure 1), click Next, and give it a 
name (1 used tw). 





New Projea 


Assistant 


▼ iuiuflt 

Carti4^ bundle 
CFPIugIn Bgndle 
Cocoa Bundle 
Generic C-i-t Plugm 
TCommand Line iltiliiy 
C++ Tool 

CDrerouruJaifoni Toot 
CoreServfceS Tooi 
FowidKiQn Tool 


VOynamte Library 

trfy niw,. 

This project buitds a command-tine root wniren in C. 



Q Cancel } ( Previous i U- Hbxt 

Figure T. Creating a new project in Xcode 2.4 

'1. Wliat is automatically created by Xcode is the famous ilello 
World!" C program. Tliis means that you dtt not have to write 
any code! You can sec the code l>y double clicking on 
mam,c file with your mouse. 

5. You now have to choose Project (D Hdii lYoject Settings, 
You will now see something similar to Figure 2. Please 
make sure that the Mac OS X 10,4 (Universal) option is 
selected! 
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# O O Project "hw" Info 

- f Build Configurations Cammcrtts 

Name: hvf 

Path: /Uiers/mtto 0 lc/«jde/C/hvif 

Ha€e Suitd Products In: 

® Defauh build products location 
O Custom locarton 

f Users / miso uk /code /C i hw / build 
Place IriTermcdtate Build Piles in: 

0 Default iotcnriedfates location 
O Build products locatiort 
O Custom location 

/users/ mts ou k/ code /C,' h w I build 

Cross-Develop Using Target SDK: f Mac OS X 10.4 {Un Wersab 

/Oe veloper / StK s; MacOSX 10 .4 u , 4 d k fchoose...) 

_ Knabtc SCM SCM System; f None ^ ^ 

fftebuild Code Sense Index } 



Figure 2. Editing project settings 

6. Now you have to go to tliu ’‘Build" la I? and sc loci Uic 
''Architecatre.s"* line. Chcx)fiC ‘*Edif^’ and you will sc^e Tigurc 3. 


Architectures to build for: 

25 PowerPC 
Q Intel 

( Cancel ^ 

Figure 3. Selecting build architectures 

7. You arc almosl dtmc. Chuck both architccluruJi and Build 
your project. You now have a universal binary inside ihe 
directory of your project! 

The results of the above process using the “HelJo World!'" 
program (the pure C version from the dw project) we created as 
an example, can be seen in the following tines: 

big:~ iiitjii[juk$ file hw 

hw: Wach-Q fat file with ^ architectures 

hw (for architecture ppc): Hach-0 executable ppc 

hw (for architecture 1386); MachO executable 1336 

Creating and Compiling the Objective-C 
code for the Widget plugin 

A Widget plugin is a fri/Jtd/e. St;irT in Xocxie, ^md selea die 
“Cot'ai Bundle'' template. In die plugin code, you must implemenr 
die Widget plugin interlace. Build your Objectivc-C code, anti yoo aie 
rciidy to use your Widget plugin. Let us now Ix^ more analytical. 
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The required 5itep.s for creiiring a Cocoa bundJe, which is 
our Widget plugin, are as follows: 


L First you have to open Xcode from /Developer/Applications 
diretariry. 

2. Go to File menu @ New Project and then create a new 
“Cocoa Bundle” from the list of templates. You should now 
give the projed a name (you must give MyPlu^in as the 
project name in tliis case)* You will then see the window 
shown in Figure 4. 
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Figure 4. Creating a Cocoa Bundie for your V/Vidget plugin 
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3. As this new liiindle does not have a base cla.ss, you have to 
create one by right clicking on tlie '"Classes" folder and then 
selecting Acid ® '"New File.. / from the menu. 

4. You will now see the “Assistant" window of Figure 3. Select 
“Objective-C class" from the Cocoa group and click “Next"*. 

''OjOQ; ASS^^t 


w 


Hejdef Flk 

▼ Cncaa 

Java 

Java NSOocumtiiT subclass 

Java NSV4cw subclass 

lava NSWindPwCoiitrpIkf sutKlass 


Obicefive-C eSasi 


Objecuivt-C NSOcKument si^class 
Objtaive-c Nsvifrw subclass 
Ob|«Uvc-C NWmdowCeRiroUer subclass 
Objecitve-C test case class 
▼ Design 

mt-* _ 




Afl Objective-C class ftle. with an optional header wbtcfi Includes tbe < Cocoa ^Cocclai.h> 
header. 


Cancel ) 


Pr^ittus Next ^ 

A 


Figure 5. Adding an Objective-C class to our project 

1 The “Assistant" window will now look as in Figure 6. The 
filename 1 gave to the new file is MyPlugin.m, and I also 
checked the ‘‘Also create My Plugin Jr checkbox. You now 
have to press the “FinislT button and you are done. 

O 0 __ Asslstanl _ 



New Objective-C class 


File Mairie: ^yfPlugin.rn 

^ Also creaie "Hyfiugiri-h* 

Ldcation: -/cfocs Jar tide f Plug in, mactec h/Myf lugj n ^ ( Choose... 3 

Add fo Proiect: MvPtugin _ _ 

Targets: ^ htyPlugui 


( Cancer ) C 3 f ) 

A 

Figure 6. 

6, Ihe only thing that is now missing is to write the aaual 
Objective-C code and arrange the last few details. You also 
have to compile your files. Do not forget to follow the 
guidelines on how to create a Universal binary executable. 

Now iJiat you have created llie basic infrastructure for your 
Cocoa bundle, you should arrange the last details, 
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1. Find llif Info.piist file l■Vc>m ihe Ke*sc>iin::e^: group. 

2, Sel the “CFBundleldentificr'' key to 
*‘coni.inaaech.wklget.my|>lugin”. 

3- Set the “NSPrindpalClass" key to '‘MyPlugiu". 

4. You should now make a change at ihe “Wrapper 
lixtension” setting in the Targets" group of pamtneiers. 
If you right click on the “MyPkigm" item and choose “get 
infer, you will get an image similar to Figure 1. If you click 
on the “liuiid" tab and scroll down until you find the 
‘Wrapper Extension" setting, you will be able to change its 
value by dtnil^le clicking on the value-tab. The new value 
should he “widgetplugin". 

^0 ^ 0 Target "MyPIugln* Info ___ ’ 

- f CertCfJl “I Rules PiopcfU^^ CommcfitiT --- 

COfiAgurttion: M ConUgUftltent ^ 

Colttctiofi: r^l SWUiia* '■'5 ^ 

S«n^g Vilye 

0 Architecrurci Multiptc ^ 

0 SDK fAth /Dweloper/SOKs/MKOSXl0.4u.Kll; ^ 

0 Suad Produett Path buiWi 

0 Ifiicrntedlite fiuild Pabukld 

0 p«r-confi9iJr4tidh ftulld Pr < ^tuliiiOte Vialu««>^ 

0 Pcr-^cynUguraticrn IrUeritit • h^ltip/c 

0 Prec<Mti|»iled H«aderi CdcOUbraTv/C3tti«sycom.^ppkJ(cDdc.S01/Sh4f4^Pre 
0 Header Seerch Paths 
0 Uier Header Search Paths 
0 Ubrary Starch Paths 
0 Framework Search Paths 
0 Rti Search Paths 
0 Always Search User Paths ^ 

0 vtrsNinidg System None I * 

A Current PrdJtct Version ' 

I » 1 - I I Ed it J Based ori; Hbn*___ 


Figure 7. Get Info from Targets group of parameters 

The Info*pUst file for the Xcode project 

The contents of the Info.plist file for the Xcode projed 
(wliicli is different from the Info.plist file that resides inside the 
root directoiy of die Widget) should now be as follows: 

<?xml version='’I,0‘' encoding^"UTF-8''?> 

<r[K)CTYPB pliBt PUBLIC "-//Apple Computer//DTD PLTST l.0//Er 
“http; //ww. appl e. com/DTDfl/PropertyLiat - L 0.dtd"> 

<plist vcrsion=*‘1.0'’> 

<dici> 

<kq>CFBurtdlcDcvclopmcntRcgk>n</kcy> 

<string>En}ilish</strijig> 

<keyXTBiindlcExccui*iblc</kc>'> 

<stnng>${BXECLrrABLli_WAME|</strmg> 

<key HT’tiundleN amt</key > 

<stnng>${PRODLICl'_NAME)</strmg> 

<key>CFBii ndtelconFiltr</kc> > 

<siring></siring> 


Web Mining Case Study #104: 
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2. DOmCT SPECIFIC DATA 
Various processors get just 
the desired information. 
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<kty>t:FUiinillc*ldcntifier</key> 

<strmg>t:om. niaaech. widpt t. my pi ugin</string> 
<kty>CFBiinilJc!nfoDicik>naryVcr!ii()n</kcy> 

<string>().0</s«ring> 

<kcy>CFBufidlcPackageTypc</key> 

<slring>BNr>l<;/.string> 

<kcy>CFBumll€Signaturc</kcp 

<Jitring>MUJoiik</string> 

<kcpCFBundlcVcrsion</kcp 
<strlng> 1.0</string> 

<kcpNSPrincipalClass</kcy> 

<str tng>My ugij:</string> 

</tlicT> 

</plM> 

The MyPlugin.h file contents 

You should now cliange the coniunLs of the MyPlugin.h Ole 
to look as follows: 

/* 

Copyright _ 2005, Apple Computer. Tnc. All rights reserved. 
NOTE: Use of this source code is subject to the terms of 
the Software 

License Agreement for Kac OS X, which accorapaeles the code. 
Your use 

of this source code signifies your agreement to such license 
terms and 

conditions. Kxcept ss expressly granted in the Software 
License Agreement 

for Kac OS K. no other copyright, patent, or other 
intellectual property 

license or right is granted, either eJcpressly or by 
implication, by Apple. 

*/ 

^import <Ci>coa/Cocoa.h> 

#import <Webltit/lrfebKit .h> 

^interface HyPlugin : NSObject 

[ 

NSString* s; 

I 

tend 


The MyPlugin.m file contents 

Last, you should change the contents of the MyFlugin.m file 
to lfK)k as follows: 

II 

// MyPlugin.in 
U MyPlugin 
// 

il Cmatcd by MihaiisTscjukalos on t6/ny/2(XK>. 

// (;opyrighi 2006 _MyCompanyNamc_.AJl rights reserved. 

// 

jfimport **HyFlugip. b" 

HSString’ s “ e"": 

f^laplcmentatlon KyPlugin 

/... 

// Methods required by the WidgetPlugin protocol 


// initWithWebView 


n 

U This method is called when the widget plugin Is first 
loaded as the 

// widget's web view is first initialised 

- fid)lnlttfitkWebView: {WehVieW) w 
i 

//NSLog{#‘"Entering InltWithWebView: X#*". w); 
self = [super init]: 
srand(time (NULL)]: 
return self: 

I 

'(vold)dealloc 

I 

[super dealloc]: 

I 

// Metbnds required by ihe WebScripling pmuictd 

// windowScripiObjcctAvadablc 
// 

//This method gb’cs you the object that you use to bridge IxTween the 
// ObfC worid and the JavaScript world. Use setVaiueTorKey: to give 
// the objext the name it's refered to in the JavaScript side. 

- (void JwindowScriptOb jeer Available: (WebScriptObject* )wso 

E 

//NSLofi(@'’windowScriptObjcctAvailablc*): 

[wso seTValue:self forKey:^’'MyPlugin“|; 

I 

// wfbScriptNamcForSclcctor 
// 

//This method lets you offer friendly names for methods that normally 
// get mangled when bridged into jav^iKcript, 

+ (NSString*IwebScriptNaineForSeiector: (SEL)aSei 
1 

MSString ‘retvel = nil; 

//NSIi^@”wdiSadptNamcFP^ 

if (aSel — @se1eftor(gptText)) I 
retval ^"getTexi*'; 

I else if (aSel “ eselectorilogHessagcr)) t 
retval - (^'^logHessage”; 

I else E 

NSLog(@*\tunkfiown selector"): 

1 

return retval; 

I 

// i sSclccLorl" xcludedPn jmWebSeript 

// 

//This method lets you filter which methods in your plugin are 
// accessible to the JavaScript side. 

+ (BOai.)l.^SelectorExcItjdRdFromWebScrjpt: (SELjaSel [ 
ir (aScl ^ ^selector(getTexi) || aSel = 
@selector(logKesGugei)} I 

tettitn NU: 

I 

return YES: 

I 

// i.sKcyExcludcdFmmWchScript 
// 

// Prevents direct key access fiom JavaScript. 

^CBOOL)iBKeyExcludedProffiWehScript: (const char*)k i 
return YES: 

1 


//The actual methods used in this plugin, to be caUcd by JavaScript and 
// identified in isSclcctorExcludedFromWcbScrtpt:. 


// gctTcxt 
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// 

// Returns thc“!lcllo World!” text to the “MyPlugin”Widgct. 

- (NSStrlng *) getText 

i 

//Tlianks RRunner 

s = [NSString stringWithFormat: Hello World!'']; 

return s; 

t 

// logMessage 
// 

// Sends the messijge passed in fram JavaScript to the console 
//Tliis demonstrates the translation of a JavaScript string to an 
// NSStringin tlic real world just call alertO from JavaScript, 

// which Dasliboard sends to Console anyway 

- (void) logMesaagoi (RSString Ostr I 

NSLogC@"JavaScript says: %0'', str); 

1 

@end 

Getting Things Together 

Now lliat you s;iw the source ctxle of the files that conipase the 
■"IVlyPlugiii" Dashboard Widget, 1 will hnther explain the necessary 
parts, functions, and practices for creating a Widget plugin. 

First, every Widget plugin should iniplenienl the followitig 
nietliod so that it can be used from within Dashboard: 

- (Id) initWithWehView: (WebViGv*)webvlew 

Dashboard calls tlte iiiitWithWebView method when a plugin 
is first loaded. You should initialize your central class and your 
important dita structure,s inside the iniiWiihWcbView method 


Second, the WebScripting interface has to be implemented so 
that the plugin will be able to interact witli the Widget, Please see the 
"WebScripting (infomial protocol)” and “Using Objective-C Fntm 
JavaScript” web links at the end of the chapter for moie information. 

Also, you have to iniplenienl the windowSaipiObjectAvailable 
metliod. Tlie definition of the windowScriptObjeciAA^iiabte merhotl 
in fhe MyPluginan Objective-C file Is as follows: 

// windowScriptObjectAvailable 

// 

//This method gives you the object that you use to bridge between the 
// Obj-C world and the JavaScript world. Use setVaIue:ft>rKey: to give 
// the object the name it’s referred to in the JavaScript side. 

“ [ void) windowSc riptOb j ectAvai lable: (WebScriptOb j ect * }’wso 
i 

//NSLi>g(@"windQvScrlptObj€ctAvailable'') : 

[vso setValue:se]f forKey :@”MyPlugin'’] ; 

1 

Apple recommends that you sliould also implement the 
webScripiNamcFofSelector method, if you want to use 
Objeaive-C methods in a mote readable forniat, 

// webScripiNameForSelector 
// 

//Tins method lets you offer friendly names for methods that normally 
//get mangled when bridged ItitoJavaScrijU 
+(tJSString*)webScrlptNaiiieForSelectQr: [SKL)aSel 
f 

NSString Vretval nil: 

//NSLog(@"wcbScriptNaineForSdectar”); 
if (aSel “=@£Glector(getText)) 

I 
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I 

else if 
I 

I 

else 

f 


retval “ @"|,eiText”E 
CaSel = ©selector (logKessage:)) 
retval “ ©"logHessage”; 

NSLog(@"\tutiknown selector"): 


return retval; 

) 

You can add method declarations for the 
windowScriptObjectAvailabie and initwithWebView Objective-C 
methods inside ilie MyPlugin.li file. It is a good practice although 
I did not use it for tliLs simple Widget. 

Now, let us go on the JavaScript side, 'I'he swapO JavaScript 
Rinction does all the communication with the OI>jectivc-C side. 
For an Objective-C oliject to l>e accessed from JavaScript, the 
following practice has to te used: 

if (HyPlugin) 

I 

var line = M/Plugln.getText(J; 
if dn)p in tlic new text 

(iocument. getslementByld('"quote")-innetHTKL “ line; 

J 

else 

{ 

alert ("Widget plugin not loaded. 

1 

i 


As you see, the JavaScript code first examines if the Widget 
plugin is available, 'rhen, it calls the appropriate Ol>jeaived" 
function and gets its input. The geiTextO function is 
implemented inside the MyPlugin,m Ohjeclive-C file. 
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Tlic alurtO function call provides debugging information 
from within the Widget. 1 should tell you that you can find llic 
output of the alert command in the console window. You can find 
llic Console ap[)lication inside the /Appliaitions/Utilitie.s direaory. 

Creating the Widget from its parts! 



Now, let us say that you have successfully compiled your 
Widget plugin and it is now time to create your Dashboard 
Widget. A Widget resides in a directory wilii the ,wdgt 
extension. You may first create a directoiy called 
MyPlugin.widget (or sornerliing different to MyPlugin.wdgtlJ and 
put your files there because if you iry to open My Plugin, wdgl by 
double clicking on it, Finder will think that you want to install 
it. Figure 8 show,s the full contents of die MyPlugin.widget 
direaory. As soon as you finish copying files, you may rename 
it as MyPlugin.wdgl. 


Figure 8. The contents of the MyPlugin.widget directory 

First, bring the My Plugin, widgetplugin directory tiia! you 
made using Xcode. This contains the aatial Widget plugin that 
should be a Universal binary. Then, put MyPlugin.html, 
MyPluginxss, and MyPlugin.js files. List, you should put 
Info.plist, Default.png, and Icon.png files and you are done! 
Now is the time to rename the Widget directory from 
My Plugin, widget to MyPlugin.wdgt. You will see some Finder 
mc.ssages, and when you finish it, your diieciory should have a 
Widget icon. Double click it to install ihe Widget, and 
Dashboard will open automatically. 

Figure 9 siiows how the MyPlugIn Widget looks inside 
Dashlxjard tefore and after pressing on it. 


AiilcT«cJi 

< lick iicrc tfi say 
Mto! 

- ^ 

Figure 9. The MyPlugin Widget inside Dashboard 
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Congratulations, your Widget is up and ainning! 

Conclusions 

You learned a lor in this article, not all of i! being 
uncomplicated. The main advanUge of plugins is that they 
hide your source axle. You can lock your Widget, your 
Widget can have an expiration date or be a universal binary 
(keep in mind that if you do a standard Widget without 
plugins, you should nut worry about umvcrsal binaries). It is 
true, though, that all these goods come at a price: you have 
to learn the powerful Objective-C programming language. 
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Patch Panel 

by John C. Welch 


Rolling out 
Microsoft Office 
Updates 


Repackaging updates for fun 
^and sanity _ 


Current Issues 



Su now you have a setup wliere if something on lye installed 
viii an Apple Installer, or direa oopy» the adminisinitor's jol) Ls simple. 
If you iLse Apple Remote De.skU}|>, and it’s an Apjile Installer, you let 
Apple Remote Desktop liandle it, or copy it over and run the insraller 
eomimnd via SSH. If it's a direct copy, then yoti, well, cx)py it. 
Simple, easy, and even allowing for stjine of tlie issues wit!i Apple's 
installer, eleg^mt. Witli A[:)ple Remote Desktop 3's AppleScript 
support, I don't even direaly interatl witli Apple Remote Desktop io 
Install these two kinds of items. I jasi dnjp diem in si^edfic folders 
and let folder actions liandle tlieni. It's pietty sweet, and lets me not 
waste a lot of time witli installing Hies on clients. 

However, when you hit a VISE installer, which is what the 
Mac BtJ stii^ uses for Office updates, diat .sy.stem breaks, and 
hard. You have to either manually install it tin each machine, or 
you have to repackage it. Sinrx* the former just is not fiappening 
unless you have a very small nuuil>er of machines, we of course, 
will look at tile latter, (Note; While Tm mally only talking about 
Office 2(X>4, this all should work just fxaichy with Office v.X) 


Hello Again 

Weil, it’s been a while since my partkiilar bnmd of 
Icxpiaciousness has graced the pages of MacTeeli, but like 
btKimerangs and had pennies, here 1 am. In tliLs month’s 
installment of Patch Pane!, Pm gtHUg to chat with you alxmt a 
subject near and dear to all our hearis; Rolling out updates to 
Microsoft Office. By “near and dear" I mean, “met with much 
eye-rolling and groaning”. This has nothing to do with 
Microsoft Office itself. Regardless of your opinion of ihe suite, 
the fact is, it's siimeihing lliat most Mac administrators have to 
support. One of the time honored tediums of the 
administrator's life is that of rolling out the upilate. This is 
something ifiai can either lie relatively e-asy, or a tedious 
proce.ss tlial [iiakes you wish we could revert back to the goexi 
old days of stone tablets and chi.sels. 

Some History 

Waaaaay hack in the dark ages, (okay, back before OS X), 
there was notliing as organiiied as the curamt Aj'jple installer. 
Oh, A[>ple had an installer, but it was not nearly as tfsisy itj deal 
with as the current Mac OS X version. So, sensing an 
opportunity, several companies came out with their own 
jirtxJucts, one cjf the biggest being IrLSialler VISE, from 
MindVi.sion. ntlp://www.mindvisianxom), VTSE had a numlxT of 
advantages over the others, inciuding not just Windows sypjx)rt, 
but actual accejHance on that platfonn. This of course, made it 
rather attraaive to a number of companies, including Adolx. 
Now, while Microsoft had, and indeed, still lias their own 
Windtjws installerCs), the rest of VISE'S feature set made it a 
g<Kxl fit for the Mac BU. 


Figuring Out what to Install 

As 1 said Ixlbie, U) naxst Ux)!s, VISE iastalleni are opmp4e^ You 
txin sex llie llle, but you can't crack it o|X"n anti .see what’s in it, 
what’s gf>ing to lx iastalled wheic, etc. You also tan’l have a Ux)l 
like Apple Renxxe l>e.sklop just install il Luckily, MitTosoft, bless 
their little rr-cxtiiric Ixaits, gives you a couple of ways to figuie this 
out. 'llie first, Ixst nietlxxl is via their uptlater logs. If yon lfx>k in 
tlie Microsoft Office 2004 folder after an upckite, you’ll sec a folder 
culled ‘'Dfxiaier h)gs”. Inside iJiai folder, you’ll liEid a text file for 
each of tlie u|xlales youVe applicxi to tliat system. 11ie updater file 
lists every file that was installed on tht! sysiejn. 

Now, Ixfore you just am (jff and blindly use this, by “each 
file" I mean just that. If it instalkaJ ten files inside a bundle, then 
you get ten entries. Now, you can directly follow the log line for 
line, but that's kind of tlie silly way to do it. Instead, read the 
file, and use it to get the minimum numlxr of files and packages 
you actually have to care alxnii. Somt^ of ihc: lines are oiwious 
like the ones for tlie main apps, (this is on my own drive, so it 
follows my own...unique...filing system. Normally, the Office 
2004 folder is in the rcK>t of your Applinitions fokler): 

instalied Aurora:A[)f>1 ications;Word Prexessing:Microsoft 
Oflke 20G4iMicrosQft Entourage 

1 nsta I led A u rora: Ap pi ica tic m s: Word P rocess j ng: M icTOSoft 
Office 2004:Microsort Excel 

Installed Aurora:Applications;Word PrtJcessing:Microsoft 
Office 2004:MicTOSoft PowerPoint 

installed Aurora:Applications;Word Processing;Microsoft 
Office 2004:Microsort Word 
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CLEAN UP YOUR MAC 
UNINSTALL APPLICATIONS 
BOOST PERFORMANCE 
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Available from your favorite retailers and catalogs. Learn more about Checkit at Allume.com! 

Checkit System Performance Suite is the most powerful tool to diagnose, clean, optimize, back up, a nd repair your Macintosh! 
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So, we can see [i instaUed new c:<>pie,s of cacli of tiie four 
main applications. Okay, dial’s easy. But tlien we see a bunch 
of lines like the following: 

Created the Folder: Aurorj:Applications;Word 

Pr(x essing:Microsufl Office 2004:Office:Microsoft Cert 
Manager.app 

Created the Folder: Aur(ira;Applications:Wortl 

Processing:MicrosQft Offic e 20()4:Ofnce:Microsoft Cert 
Ma na ge ra p p: Con tents 

Installed Auroni:Applicaiions:Word PrcKX'ssing:Microsoft Office 


2004;Office:Microsoft Cert Manager.app:ContenLs:Inro.pii.st 

And this goes on for alx)ut 30 lines. Does this mean you 
have to now deal wiili 30 separate files? Nope, ft means you deal 
witli one: The Microsoft Cert Manager.app, which lives in the 
“Office" folder inside of the main Microsoft Office folcien 'litis 
can be kind of tedious to parse, although since MicTosoft is 
thankfully aHtsisteni in how it does this, you can sc^ript this 
parsing out fairly easily. However, there Ls an easier way, one 
that all administrators will of course already know about, and 
that is the Read Me file. 


HostedS tm / 

HostedStore provides a TURNKEY 
SOLUTION FOR CREATING A WEB STORE, 

yet is extensible so developers can use 
the application as a base for creating 
customized solutions for their clients. 

The extensibility of HostedStore provides a 
structure which allows developers to 
create modules that add new functionality 
or alter the built-in features. 






We are seeking software resellers, hosting 
providers, developers, and designers that 
currently offer or plan to offer ecommerce 
solutions to their clients. Resellers receive 
a discount off of the published list price of 
our software and are free to bundle our 
software with their own products and/or 
services. 


[ 


www.hostedstore.coni 
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With every tipclatc, the Mac BU lias a Read Me file that lists uut 
the flics wliidi ate ujxlated, and their new verskias. (For tliase of 
you who are Brimnniai fans, this is die MacTOf^aedia, whereas die 
iastaller log is the Miciopaedia.) So ratJier tlian parsing through the 
Updater Log file to figure out whai was installed, you can just ase 
die Read Me to see what was installed. It’s much simpler Now, the 
Read Me won’t tell you the .specific l(x.atioiis of the files, so it’s not 
a complete replacement for llie Updater Log, but thats not a fiuge 
issue, detx:nding on how you ixidd your upckter. 

Building Your Updater 

So, w^e now have two lisis of file.s, one detailed, one not. 
Now, how do you build die updater? Well, the answer is, 
“Whatever works liesl for you". No, I'm not trying to lx: sraamiy, 
it's just tliat there are a lot of ways to do this. If you use Apple 
Remote De.sktop, as 1 tio, then you can just do a drag of the files 
to a list of dc*stination clients, and chose “Same Relative 
LtxraLicM" as die destiruition, like in the screeashot lielow:^ 

ftea... 

^ Copvttems 

|~4 mtq Uh Hit At d)c|i' lA lAUlt tfmn. 


Raca iln: f Seme FflliiJvc l«caUifrn 



If item itmov sKitu * ReiMiKi iwn 


ircftii AwneoMpi to 



If i fuvnii^ Actun O 'SiAp iht lii worn 

Afttf CiOdVMii0 ^ Open 

0 IflemnK ntfwof k dnj 

uuqc ~ LMt CO hltpUvCHi per IKWHI 


Af>5niin 

amiM 

Qffilnf 

AU)h« Aai¥t 

ikim* md 


H'icTiji sa ' 

AIo'iaMk 
bcIcUird 
^ ValkyilA 



Csch«dui€... ) CbED 
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Copy Items Dialog from Apple Remote Desktop 3 

Drag all die file.s you need to copy over, pick “Same reblive 
kxiation", click on copy, and watch the fun. (to, / fvaiize n^rie 
of my targets are atrrenUy running or mnning AMD). You cnin 
of course, with Apple Remote Desktop 3, AppleScript this, via 
Cxipy Items task. Just set tile iocation" propeny io “same relative 
kxiition" in the properties for the ta.sk. Ytni could even set up a 
Folder Action that would always copy whiUever you dropped into 
it to the Same reblive ItKalion, and he even lazier. Tliat of coui^ 
is my preferred method. Life’s too short to watch file copies* If 
you aren’t using Apple Remote Dc.skto[i, or you prefer using 
Apple Iastaller packages, you can use Apple’s FackageMaker tool 
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to bundle up tiie update into an install package, and then use that 
via Apple Remote Desktop or your i<k>I of c:hoice. C'lhere's a 
PackageMaker article in this very issue, so Til not get into using 
PackageMaker, as it would l>e redundant,) 

If you like using Apple’s Installer packages, but are not 
thrilled with PackageMaker, Uten a third party option is to use 
Iceberg, ^ hnp;//s.sudreJfee.fr/'Sc: ^ IcelK^tg is i>illed 

as a Ixaicr way to make Apple lastailer packages, and in general 
IVe found that to be ime. TIte only i.ssue with Iceberg is that it 
rer[Uires the use of a daemon that runs as rot^L If that's not an 
issue for you, Iceberg is worth checking out, I also find the 
documentation on lcei>erg's site to be solid as well, always a 
welcome touch for an installer builder. 

Please don't think that these are the only options out there'. 
When you're talking alxuil straight file copies, which is what 
updating Office is, once you install it on an initial system, there 
are as many ways to roll tills out as there are ways to copy rtle,s. 
If youYe thinking "that's a lot of ways”, well, you're right. Once 
you know where to kxtk for the correct information, then how 
you get tiie copies onto die end user system is totally up to yf)u, 
and your normal workflow'. 

Two Caveats 

lliere are of course some tilings to keep in mind that could 
trip you up. (You knew tliere would lx:, nod ling’s ever that 
,siinf)le.) First, the main applications in Office, namely Word, 
PowerPoinl, Excel, and Fntoimtge are traditional dual fork 
applications. That is, they liave a resource fork. Tliai’s probably not 
going to change until the next relea.se of office, still known by its 
nom du as “Office 12". So, when you're copying Office 
upcLiies, you really want to make sure that whatec^er method you 
use d(x:sn't do bad thitigs to resource forks. Otherwise, the 
applications will break, and your users may do bad things to you. 

The other tiling to watch out for is the Microsoft Database 
Daemon. This is a daemon that runs whenever one of the main 
Office a[)plications is ainning, or it runs at login if the user is an 
Entourage user and has set events or tasks with reminders. If you 
up<late the Microsoft Database Daemon while it's running, and 
dicre arc changes made to it, then the end users, particularly 
Entourage users could get otkl messages that might lead them to 
think their Entourage database died. That wouki make them 
flusiered and stern, especially if they find out later tiiat it was just 
an update doing diLs. Since the daemon only runs witliin a user 
login context, ifie obvious st>lutk>n is to not run the update until 
the users have logged out. If this isn't possible, then I'd highly 
recoinniend adding a post install action tliat restarts the daemon. 

Conclusion 

If this all seems preuy simple, well, it is. While the Mac BU 
really, really, realty needs to move to Apple Installer packages 
sooner titan later, their laudable habit of providing detailed 
installer logs, and updated file lists in the update readmes makes 
what could he an onerous task into one dial's just mildly tedious 


and annoying. As long as you keep my warnings atxjut resource 
forks and the Database Daemon in mind, rolling out Micro.soft 
Office updates shouldn't lie hard at all 
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Building a dimtributian installer package 


By Jose R.C. Cruz 


Introduction 

Software procUiei cjualiiy is judged on seveml factors. Firstly, 
the prodiicl must provide the features needed by users to do 
liieir tasks effectively and efficiently. Secondly, it inusi provide a 
localized user interface that is lK)th ccjnsisterit and intuitive. 
ITiirdly, it tnust he accompanied by an extensive online help 
system, explaining each feature in simple anti cont:]se terms. 

rinally, die product must lie easy to inslali or upgrade. It is a 
harsli fad that higli-tiualily software is easily marred by poor 
insUillalion and buggy upgrade experiences. 'IhLs is especially irue 
witli Windows software, which c:an fail when a file is incorredly 
installed, or replaced by an older and pcrlKips faulty version. 

The MacOS X issue 

Mo.st MacOS X .software is distributed as bundles. A bundle 
is a special directoiy used to contain files tliat comprise the 
software product, For a software applinuion, the bundle will 
contain the executable axle, driver code, graphic files, and help 
files, Fi»r a .software driver, it will contain the executable axle, 
and a collection of plisl, or property iLsl, files. 

Because of bundles, different iechni<|ues air RX|uiied to 
distribute MatOS X software^. Hie simplest one is to distribute the 
software* ils an airliived file. Hie most |x:)pular arcliive fbnniit.s in 
use are , sit, . zip, and the ever-popular , gz (also known 
as the tatiiaU fonnai). Users download the arcliive file, and 
dec()nipres.s it to retrieve tlie software prtxiuct. 1hey then manually 
iTKive die prtxlua to the desiretl direaories. Tlus technic|tie Ls tjHen 
used for distrihiiring freeware* and sliarewaie prrxlucts. 

Another technique is to distribute the .software as a disk 
jVe. Wlien the file is doubleclicked, it is mounicd on ihe 
Finder desktop like a regular disk voluiiie. Users can then move 
I he st jftware from the image to die desired clirectoiy, 'i his 
technique is [lopular for distributing single software applications. 

However; Ixali teclitiiques expect uset>i to km)W beforehand 
if dieir systems can run the .stjfiware prtxlud, Both also expect 
ii.sers are also expecteti to know how to st*i the file or directory 
l^ermlssions if required, Finally, neither technkjue can lx- 
kx^dized for a specific region. 

To address diese issues, Apple provides the tfK>l to create 
an installation package that is lx)ih kx‘;ili74ihle and scripiable. 
‘Fhe name of the tool is FackagevMaker. 

Introducing PackageMaker 

The PackageMaker Tool 

The PackageMaker UkjI is used to [Prepare software 
prcxiucLs for distribution. It creates a specinlized bundle, called 


a component package (, pkg) to contain the software product 
or payload. The package is tlien processed by the Installer 
a(>plication, wliich is bundled in all MacOS X systems. It is dus 
application that extraas the payloatl and moves it to the 
approfiriaie direaories. 

To learn more alx)ut com]xment packages* read tlie Software 
manual, which is availal>le from Apple Computers, 

Two other types of bundles diat can lie created are 
melapackages and distribalkm packages. Both are used io 
contain multiple component pat kages. They also allow users to 
selea whit^h paykrad to install on their computers. 

Until recendy, a metapLickage is the only way to distribute 
tmilliple payloads to the public. 'I'his is no longer the case with 
MaL<')S X 10.4, and the more manageable distribution package. 

The PackageMaker Competition 

PackageMaker is not ihc only insiuller ukjI available for the 
MacOS X platform. Ollier companies also provide their ow'n installer 
prixluds for diat platfonik 'fhree of the most fX)f>ular ones on the 
market ate lastallerMaker, lasialkTYLse, and lastallAnywhere. 

All three insUiller pnxlucls use proprietary algorithms and 
file fonnats to contain their payloads. Also, InstallerMaker and 
Installer Vise will correctly handle files that have resource forks. 
Both lastaller Vise and InsiullAnywhea' also provide a feamre 
called billlioards, Tliese are used to display additional 
infonnation while the payioad.s are Ix'ing installed. 

Firutlly, all three pr(KJiKts can create installers that are 
localized for rnukiple regions. Also, fnstallerVLse and 
lnstallAn\where can create installers for multiple platform 
targets. InsrallerMaker, on the other hand, supjxxts MacOS X as 
its stile raigei plaifbnii. 

Pricing for InslallerMaker and InsiatlerVise are based on a 
[>er volume basis. It can ningt? from $2S0 to $5(^00 a year, 
depending on ihe distribution volume of each payloati. On the 
other hand, InstallAnywhere can Ix^ purcha.sed for a one-time 
fee of no more than S35tK), InstallerVise can also lx purchased 
for a one-time fee, bui only if it is used for in-house or 
educational prt)jecLs. 

For an open-source alternative, there is tlie feeberg tool 
from St^hane Sudre. ‘I'his t<K>l c*an also lx* used to create 
component packages and melapackages. It also has a more 
streamlined interface for siip[xirting locttliziifion and scripting, ft 
can even create metapackages without the need for component 
packages. Its only disadvantage is lliat it does not suppon 
distribution packages. However, this could change in future 
verskms. [Ed. Note - also be aw'are that Iceberg rec|uires a 
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daemon that runs as root, and that makes some people 
uncomfonahle, Tlial said. Iceberg ha,s an easy u> use Ul that 
makes creating packages very easyj 

The PackagcMaker Advantage 

'riie most notable advantage of tlie PackageMaker tool is 
that it is free. Developers only have to download the latest 
version of Xcode to get a copy of I his tool However, the 
download does require a high-speed connection. This is because 
the entire Xcode installer itself is nearly 1GB in size. It would be 
more convenient ftjr some developers if PackageMaker c^an \ye 
downloaded separately. 

Another advantage is the ease in which the tool suppons 
localization. Localized copies of Readme and Software LicerLse 
files can l)c loaded into die appropriate . Iproj [>undle. Text 
used by some interface elements, such as warning dialogs, can 
also be localized using a .string file, Also, testing the 
localized package is as simple as changing the preferred 
language setting in System Preferences. 

finally, the tool allows scripts to be added to the installer 
package. Each script is executed liy line Installer applicaLion at 
each stage of installation. The scripts are often used to perfomi 
platfonn checks, or to customize the installation. 


The Distribution Package 

The package formal 

The disiribuiltm package is live preferred format for 
handling iiuiltiple f>ayloads for MacOS X 10.4 and newer. It 
provides a tnore organized storage for localizetl text and installer 
.scripts, ft also allows insullation choices to he easily aistomized. 

The structure of a Ixisic distribution package is shown in 
Figure L Notice that each component package is now stored 
within the Packages clirectoiy. Also, notice that the Resource 
directory now only stores die .Iproj bundles. As mentioned 
earlier, these bundle.s contain localized installer files such as die 
ReadMe and Software Licease files. Finally, the XML file, 
distribution.dist, will now contain the loc'aiized text and 
in-staller .scripts, 

You can still use a nietapackage to deliver multiple software 
payloads. Rut, he aw^are that this format i.s now deprecated, and 
will lie phased out in future versions of MacOS X. Use it only if 
you plan to suppon versions of MacOS X earlier than 10,4. 



Figure 1. Structure of a distribution package bundle. 


Creating the project 

To start working on a distribution package, launch 
PackageMaker and choose New from the File menu. Select 
Distribution Project from the New Project 
Assistant (Figure 2) and click on the OK button. 
PackageMaker will then display an empty project window as 
shown in Figure 3* Make sure to save the installer project with 
the appn>priatc name. 



New Project 


i single Proiect 

M<upA£kaot Project 




A distribution i% n simple «nd powerful mtuns to Specify en 
entire Iniuller experience. Drj,g pre-made packages onto 
distribution choices to add them. Distributions are only 
compatible with Mac OS 10>4 and above. 


Figure 2. The PackageMaker Assistant. 


Do not use the Assist Me butUin to create a project for 
your distribution package. At the time of this writing, assistive 
support only exists for component packages and metapackages. 
Hopefully, suppon for distribution packages will be added by 
the lime you read this sLaLeinent. 



^ PunHOAlvikifilli^n 

OilMManOiUiH 


•; deluJSuiiru 

Installer Inivrtacc 

«ifnpW-iirp 

# nr 

SfiOM EdlOt ) 

vOidml untv I tle 

Tak: De'IHi DHtribuElein 




S 

(£> i 


1 

1 


Figure 5, The Distribution Package project window. 

Defining the interface 

As shown in Figure 3, tlie first panel displayed In the project 
window is Installer Interface, This is where you assign 
tlic official Uile of your distribution package. It is also where you 
define the user interface for your package. To start defining on 
your interface, click on the button labeled Show Installer 
Interface Editor. Then follow tlje insunctions presented 
by each editor panel. 
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Three iSHiics to keep in mind while working (m your 
installer interface. First, the project always assumes that the 
package is IfKali^.eci for English, Tliis is regardless of the current 
language set in Sy.stcm Preferences. In other words, even if Uie 
current language is set to French, localized Files assigned to the 
project will he scored within an English, iproj bundle. 

Second, the project accepts background image files 
rendered only in one of the following formats: EPS, GIF, ^)PEG, 
pdf; and 11KF. It will not accept PNG files, nor will it convert 
those files to one of the supported h^rmats. 

Finiilly, the project does not allow additional . Iproj 
bundles to be easily added to it. I'he only workaround is to first 
build the distribution package. 1hen open rhe package using the 
contexiual menu command, Show Package Contents. Once 
opened, the *lproj liundles can then he copied into the 
Resources directory of that package. 

Hopefully, these Lliree issues will be cotreeied in future 
versions of tile PackageMaker tool. 

Defining choices 

Most of the time, your installer ])ackage only has a single 
payload to distribute to your users. IhLs is esi>ecially tine if the 
payload is a single self-contained application. Sometimes, however, 
your package may iiavc more dian one payload. In Uvis case, you 
may want your u.sers the option of choosing which payload to 
install. You may ai.so want your installer package to decide which 
payload can lie installed onto the latgel platfonii by default. 

The PackageMaker tool now allows you to define the interface 
for installation choices. You can specify whether to provide an Easy 
Install or a Custom Install option. You c:an also spcx:ify 
which payload should be selected by default. Bear in mind tiiat this 
feature is available only for the distril:)Ution package Ibrniat. 

The simplest way to define the interface for installaiion 
choices is to use tlic Contents panel (Figure 4) on die 
Installer Interface Editor. Tliiough this panel, you can 
add, edit, or remove an installation choice. For example, dick on 
the button lalx:4ed Add Choice to add a placcliolder entry for a 
new choice. To edit, select the choice from the listbox and change 
its nam e or def:i u I r sta fes usi ng the C o n t e n L s Inspector. 

You can also use the panel to select the default installation 
inode. Simply select the desired mode from the drop-down menu 
labeled Oser Sees. Choices include Easy and Custom 
Install, Custom Install only, and Easy Install only. 


Finally, you can also use tlie panel to create a hierarchical 
order of installation choices. Simply select a choice and move it 
to the desired spot on the listb<ix. Currently, there are no 
established limits to the nuinber of hierarcfiica) levels. But a 
good rule of thumb is to have no more than three ievels of 
choices for visual reasons. 

The example stiown in Figure 4 Iras four installation choices 
defined. The Single product choice will install a single 
payload. It is also set as the default installation choice. 

I'he Multiple products choice will install two 
payloads. It is further divided into three more choices, each one 
associated with a different payload. Notice that two of those 
sulx'hoices are set to be invisible by default A script will be 
used to display the ai>propriate .subchoice ba.sed on the target 
jdatfbniu T\m will lx* explained later in this article. 


Adding payloads 

Whenever you add an installation choice, the PackageMaker 
tool also adds an entry for that choice in the project window, To 
assign a payload to an in.staNation choice, first scdecl the choice 
from the listix^jx. Then choose Add Package from the 
ProjecL menu to display the file selection dialog. Navigate to 
the component package for the paykiad and click on the Open 
Imlton to scicci it. Additional details on tile assigned payload are 
then displayed using the Package Settings panel (Figure 5). 
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Figure 5. Details on the assigned payload. 



Figure 4* Defining installation choices. 


In die extmiple shown, die panel identifier tlie assigned 
payload as a kx:al component package. IL displays die size, 
bundle identifier, and version nuinlxr of diat package. It also 
shows that the package wUl lie ioc’ated iaside the Packages 
directory. It further .show.s that installing the package will have to 
lx autliorized by llie system adiiiinistnitGr- It al.so shows dial die 
Installer application will simply quit after installing the payload. 

You can use the Package Settings panel to specify a 
differeni loc'aiion for the payload’s component package. One 
location is the same directory as the distribution package. Use 
this if you want users to be able to install the payload directly 
from the component package. 


MAIliCH 


Distributing with PackageMaker 39 



























Anoihe^r kxalien far a comyx>ncnt package is on a 
remombfe media. Use this option if your payloads are large 
enough tliai [liey ran not all tit into a single CD or DVD. One 
usage example Ls die CD distrit)uli{)n of MaeOS X. 

The third and tlnal location is on a nehmrk sermv. Use tiiis 
option if yon warn tt> tio a network installation. A good usage 
example is the software update feature of Mat:OS X. 

Note ilm these other locaiioas are uvaiiable only if you deselect 
the checkbox labeled Copy Into Distribution Package. 

Others settings that you can make on the Package 
Settings i>aiiel are die aniheniicalion and posHmkdi actions 
for the payload. The former action is exeaited before the 
payload is installed. The latter action, on rhe other hand, is 
executed after the payload is succes^sfully installed. 

If the payload has its own authentication or post-install 
action, tho.se acdoas are displayed on the Package Settings 
panel. You can then change the type of audienncalion to he 
performed, but you am not disable it. You can also change the 
type of post-iiisrall action as well as disifole it entirely. These 
clianges dten overricie ihe sellings used by the payload. 

Localising choices 

When choices are defined ilirough the Can ten is panel 
(Figure tlie PackagcMaker too! always assumes that die 
choices are localized for English, To localize dtese same choices 
to other languages, you need to use liie Choice Settings 
panel (marked in green. Figure 6) on the projecl window. 

To localize a si>eciric clxiice, selecl rhe choice from the 
listbox located on the project window, 'rhen click on the 
checkbox labeled Make localizable. The tool then as,signs 
unique string idemiriens for eacli text fiekf It also repkiees the 
English text contained by these fields with the idendflers. But the 
replaced text ts still available for editing as seen later on, 
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Figure 6. The Choice Settings panel. 

Now to start adding localized text, click on tlte button 
labeled Edit Localizations, 11iis will display a sheet dialog 
wherein you can enter your text. It will also display the original 
Englisli text on that same tlialog by default (Figure 7). 



Figure 7. Localising the text for the installation choice. 

In tlie Language text field, enter the designation code 
assigned for the target language. For instance, if you are 
localizing for French, enter the word French iiiKs tite field. But, 
if you are localizing for Portuguese, enter the eharacters pt into 
tliai same field. These designation codes are pan of tiie 1S0~639 
standartl. For a complete list of language designations, go to 
lmp://i^,.L4loc,gov/slandards/iso639-2/englangn,hlmL 

Figure H shows an example of the installation choice text 
localized in French, Once you have enieretl the localized text, 
click on the Close button to submit your entries. The Ick) 1 will 
save the kx-alized text into the distribution.dist file when 
it builds the distribution package. 
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Figure 8. Localising for French. 

Oiice ytni have finished defining tlie interlace, ciioiees, 
]>ayloads, and Joealizations, you can build a clistribution package 
to ,see the result.s. To build the package, choose Build from the 
Project menu. Then use the ensuing dialog to save the 
package into the approjiriate location. 

The Distribution Scripts 

Controlling the Installer 

As meniioned earlier, the disiribution package uses 
,scripts to control the installation process. These scripts can 
perform a variety of tasks such as validating the target 
platform, or checking to see if a target voinme has enough 
space. 

Figure 9 shows how the scripts are exeaited in a ry]>ical 
installation process, LIser actions that are enclosed in [siinare 
bmeketsf iitc con.sklered o|)iional. 


40 December • 2Q0Q 


WWW.MACnCH.COM 





































Susbsription service now available, running on 
Mac OS X Server. 

Details at: www.netteamserver.com/subscribe 


NetTeam 

SERVE 




Connect your people, contacts, relationships, projects, tasks, documents, 
blogs, web content... your knowledge itself ... and magic follows. 


Most businesses already have this data but in different systems, used by different people, in different 
departments. What a nuisance! NetTeam Server brings it all together, in a web app that everyone can 
use, anywhere. What a difference! 


NetTeam Server 


Features 


NetTeam Server is a business process, content management, collaboration 
and social networking web app for businesses and organizations of any 
size. It offers people, project, task and document management services 
and has a powerful API to support customization. 

The triangle represents NetTeam Server's unique combination of 
functionality for three critical areas: Process, Content and Community. 


NetTeam Server*s fundamerrtal constructs are 
People, Projects, Tasks aixf Documents. 

These four are central to all business activities, so we 
bring them together in a coherent workspace that 
makes NetTeam Server a true Business (^raiins 
System, The portal interface can be tailored to nnatch 
client branding and linked systems, and includes five 
Editors (see screen^iot) and a modern, AJAX-enhanced, 
configurable user interface. 




User roles determine access privileges and which (if any) 
tods are presented on login. Blogs are used extensively 
to support publishli^, information and knowledge 
management. Wikis will be available in a late- 
summer update. 


NecTfrikm 




- Web Content/Site Management 

- Web Document Library 

- Project and Shared Blogs 
• News Editor 


- Users, roles and relationships 

- Simple CRM 

- Social Networking 

• Profile & Personal Blogs 


NetTeam Server is available for Mac OS X Server, Unux and 
Windows platforms and supports all leading web browsers. 
A Web Services API allows tight integration with other 
systems and single sign-on. Vie also offer a Java mobile 
client which can be tailored to support mobile workforce 
applications. 

NetTeam Server has been successful in deployments 
serving from 10 to 10,000 users and may be installed on a 
server of your choosing, used on a dedicated server we 
provide, or rented as a subscription service (multi- 
comprany server). 

Consultant, reseller and developer enquiries welcome. 


WeTe a good choice even if you only need one of these, but if your 
business operations embrace two or three, you'll love what we can 
do for you. 
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Figure 9. Script execution within a distribution package. 

After the user uuihentiaiies the insiiilbikjn prtxess, the 
InstallationCheck scrip* is executed. Tins script cftecks tlie 
tai^et platform to see if it has the requirements necessary to 
support the payload. If the target passes the chec'k, the .software 
license agreement is then displayed to the user. 

When tlie user accepts the terms of the agreement, the 
VoiumeCheck script is then exeaited. 'lliis script tests every 
mounted volume to see if they have the storage capacity io 
contain d»e payload. Tliosc volumes that fail the test will have a 
stop ic<jn badge apj>ended to tlieir disk icon. 

At this point, the user selects a target volume. Tlien, tlie 
component package is retrieveil from the Resources directory. 'Ihe 
preflight script of the package is first executed. Then, 
depending on the type of installation, the preinstall or 
preupgrade script is executed next. Once the payload ts 
.successfully installed, the postinstall or postupgrade script 
is executed. Finally, the post flight .s^xipt of the package is 
executed to finish Ihe installation. AJ'terwards, tlte desired [>ost- 
insiall action is tiien f>cribnned. 

Note iliat if eitlier the InsmllationCheck script or one of the 
package scripts fail, the entire installation pTxx:e.ss is Uien 
cancelled. Also, if the conijxjneni package does not have any 
scripts, the post-instaU action is then performed after the payload 
is iastalled. Bur if it has its own InsiallationChec^k or Vc^lumeClieck 
sc^ripts, they are then ignored. 

For die sake of simplicity, the diagram assumes that there 
is only one component package. If there is more liian one 
package, their scripts are executed in a specific order. For 
iaslance, if the package names are package 1 and package2, 


the preflight script for packs gel is executed first. This is 
then followed by the one ft>r package2. 

Scripting with JavaScript 

Distribution sexipcs ate all written in JavaScripl. This allows the scripts to 
lx- cmlxtlded witliin a se[xirate docuinenL The distribution package, for 
instance, stores its scripts taskie the distribution. dist file. 

JavaScript enables the scripts to interact with the control 
widgeLs on the installer interface. It helps reduce the number of 
installation errors with its exception handling system. It also 
simplifies script maintenance by LLsing a standard runtime 
library. Make .sore U) use version L2 of the language w'hen 
writing your scripts. 

Both the PackageMaker tool and the Installer application 
u.se the same runtime lifirary. This library provides three h£isk 
objects that can be used by the distribution script, Tlie 
choices object is use to interact with the inslallalion choices 
defined by the Contents panel (Figure d). The systein object 
is used to retrieve variotts pbilorm data such as file paths, and 
lORegistry entries. It is also ii.sed for debugging and for 
executing external .scripts. 

Finally, tfiere is tlie my object. Tills ,sj>ecial global object is 
used to reference tlie current context of the JavaScript process. 
For instance, the my. target context refers to the current target 
volume. The my. reault context refers to the re.sTjlts of the last 
InsLallalionCheck or VoiumeCheck script, 

A complete li.sting of all the lilirary meThod,s is beyond tiic 
scope of this article. Instead, six of the most commonly u.sed 
methods are listed ^ls Ibllow.s, 

• my * target .availabieKi lobytes — Checks die 
amount of free space available the target volume. Returns 
the value in kilobytes as an iiileger. 

• my, target ,systemVersion — Checks the version of 
MacOS X installed on ihe laigei volume. Returns tlie version 
numlKT a.s a string, 

• system, file . fileExistsAtPa Lh (aPath) — Checks 
to see if the specified file is preseni. Tlie input argument, 
aPath, is eniered a.s a UNIX path siring. Returns a TRUE if 
the file exists, FALSE if otheiwise. 

• system, gestalt (aSignaturc) — Checks tm a specific 
system seuing using ihe Gestalt Manager, llie input 
argLiinenr, aSignalure, is a four-character identifier Returns 
the result as a JavaScript objecl. 

• system, log(anArg) — Oulpuis a string, prefixed with 
the characters JS;, to tile PackugeMaker s debug console. 
The input argument, aArg, tan either lie a string or a 
JavaScript object. 

• system.sysctl(aNode) — Returns the setting of a 
.Hpectfic kernel state. The input argument aNode is the siring 
de,scribing the kernel .state mxle. 

For a more complete list of library methods, read the 
Installer Release Notes, wliich can be found at 
htTp://deve!oper.applacom/releasenotes/DevelopfirTools/lnstaller.htmL 
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The Global Scripts panel 

'Ilie Global Script panel (Figure 10) h where you define 
your clLstributinn scripts. Also, it is where you scicel which scripts 
to use as m lasiallationChcck or a VoluineCheck script. 

Global Scripts 


Inttillmion Chtek Script: 


ch«kTabl«t0 

Volum# Clwck Scriff; 

m 

fnlriiriitiiTrihutifin jiffliWpi funffion rail 

‘4 

Q DtiemaJ Scnpti 


ddbftl FunetlaAi: 


(first kfwl 


DemoWkifnlngO 



IniUl t«t 10 nCStckftAMO 

volumtChtckTrgtfO 
C«K ADOwngr^df 0 
DimoFatdIO 

T^CEOiatcHl 
flInrSmjtti Volume sC 
kViOwcktt 
ch«kTtt>l*tO 

(7) ©O (S 


Figure 10. The Global Scripts panel 

Tlie project template for the disirihiition package Cfintalns 
tJiree basic scripts, iuich script pertV>rm.s a default action, whit h 
are describt‘d as fblltws. 

• install at ionCheckRAMO — Checks if the largei 
platform has at least !28 MBytes of physical RAM installed. 

• volumeCheckTiger 0 — Checks if the Uuget system 
version is at 10.4 or newer. 

• choieeJsADowngradeC) — Checks if tlie user is al)out to 
perfcimi a downgrade installaijoit as tjpptxsed to an upgnide. 

Both scripts return ii TRUE if their conditions arc valid, FALSE 
if otherwise. 

To c^it a script in the Global Script panel, select its 
name from the list and click on the button laljeled Edit. To add 
a sitTipl, click i)n tlie [dus-sign button ItKatcd on the lower* 
left corner of die list, and enter the script's rmitie in tlie space 
provided. 7o mmwe a stTifH, f>elecf its name from the li.st and 
click on the minm-sign button. 

To select the serifit for the InstallationCheck, ty^j>e its name 
into the appropriate field. Use the same prot'edure for selecting 
the script for the VolumeCheck. Altematively, you can select the 
name of the script from the drop-down list next to each field. 

Scripting installation choices 

Scripts can reconfigure tlie default installation choices based 
on the target system environment, ihey can also recemfigure 
other choices based on user input, They can even clieck for 
specific software products, and then enable choices, such as 
I bridge software, that will internet with those products. 


For example, a distribution [rackage carries two vemons of 
tlie same software prcxliict. One version is suited only for 
PowerPC-based systems, while the other is for ^ntel-ba.st^d 
systems. A script am cfieck llie taiget prt>cc,s.sor ly|X‘. It can then 
hide and sliow die appropriate installation clioice based on the 
results of the check (Listing 4), 

Assigning a script to an installation choice is done tlirougii 
ihe Scripts lisilx>x (encircled in red in Figure 6) of the Choice 
Settings panel. Note that the first three entries in the listbox 
have a start_ prefix. 'Hiese correspt)nd to the thrt'e dvfaull 
states of that installation choice. Usually, you set the default 
states using die Contents panel (Figure 4). You can also set 
diose states by double-clicking on each eniry, and eniering 
either a TRUE or FALSE value. 

The next diiiec entries also correspond to each state of the 
installation choice. I'hese ones am scriptable. 'lo assign a .script 
for rach entry', double-click on iIk! adjoining field to bring up 
the scripl window. Tlien enter die name of the glohal script in 
the window provided. 

Do not define a distribution script for the instaliation 
choice throngb this window, If you do .so, the distribution 
package will generate a JavaScript error at runume. Use the 
Global Script panel to define the script. 

Defining a distribution script 

llie script window (l-igure 111 is where you create or e<lit 
your distribution script. It is displaytxl whenever ytju select a script 
from live Global Functions lisibox (Figure iO) for editing. 
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Figure 11. Editing a distribution script 

You can enter the JavaScript code diretaly onto the serript 
window, or use the built in Re<|iiiremunts Editor, You can also 
use an external text editor to write or edit your disiribution 
script. Regardless of which approach you use, l>e aw^are that 
you can only aWt one .script at a rime. 

To iLse an external text editor, select its name from the 
drop-down list, and then click on the Edit bunon. 
PackageMaker first saves a copy of the scripl into a temp 
directory. It then tjpens the copy using tlie selected editor. Any 


44 DFCfMBER • 2006 


WWWMCTtCH.COM 



























Missing a few issues? 

Here is your chance to catch up. 


The MacTcch CD - Volunes 1.01-22.09 is packed with more than ever before - The 
entire archive of MacTech Magazine, that's over 2700 articles from more than 250 
issues (1984 - September 2006), all 29 issues of Apple's develop, 21 issues of 
Frameworks magazine, all of the source code, working applications, full documenta¬ 
tion, demos for techs, and more! 

Everything is displayed in the all new, very fast, 
very searchable MacTech Viewer! A new appli¬ 
cation that has been designed specifically with 
Techs in mind Search quickly through 20 plus 
years of great information provided by MacTech. 

Information to make your life easier. 


Requires Mac OS X v. 10.4.5 or later 




Toll Free 877'MACrECH, Outside US/Canada: 805-494-9797 • http://vwvvw.mactech.com/cd/ 




































changes made u> ihe scripi are automatically refleaed back into 
the script window. 

Using an external text editor allows you to take advantage 
of the editor's various features. For instance^ BBFdit will allow 
you to perform search and replace operations that are not 
possible in the script window. It will also assign colors to each 
JavaScript keyword thus making ilie script easier to read. 

At the time of this writing, PackageMaker will use one of the 
three external editors; BBEclit, BRKdit lite, and TextWrangler. FuLum 
versions of the tool may allow users m add additional editors such 
as jEdii and Smuluon. It may also allow die script to be open by 
default with an external editor, instead of the script window. 

lb use the builMn Hecjuiremenls Editor, select its name from the 
drop-down list, and then click on the Edit button. PackageMaker 
dien displays the editor's dialc^ panel as shown in Figure 12, 



TMTHlr- Tnfer: _^ 

rwl: Hnuvr- liiii iv m tr^ 


ShosiM ft ! Ji ^ eJ Kit tili i ii iH flv 

^ I ^ Q 01 I 

^ ^ lil 00 

' _**^ **%***> _Jjj ^ ' f- #1 -iBtflil' ^ 0 0 , 




Figure I2< Using the Requirements Editor. 

In the above example, the Requirements Editor is used to 
define die script named MyScript* lliis script executes a single 
subroutine named testScript. The subroutine then performs three 
system checks. It reium.s a TRUE if ilie target platform meets the 
following conditions: 

• it has a processor clock .sfx^etl of exaaiy 600 MIIz, 

• its processor does not support AltiVec technology, and 

• its B.SD subsystem is compatible with at least version 2.0 of 
the POSIX standard. 

But, if the target platform fails to meet any of these c:ondiiions, 
the script will display the appropriate warning message. 

When die Ret^iiiremenis Editor is used to define a script, it adds 
a pmjxrrty list to that script. This property list defines the editor 
settings that were used for that script. Avoid making changes to tills 
list if you still want to edit the script using tlie Requirements Editor 

Examples of distribution scripts, 

One example of a distribution script is shown in Listing L 
This script Is often used to perfonn an InstallationCheck. 

Tlie script checks the target platform to see if the Xcotle 
development environment is installed. If the check fails, tiie 
script then displays an error dialog to the user. Once the user 


replies to the dialtjg, the script then tells lastaller to terminate 
the entire installation process. 

Listing 1* Checking for the XCode 
development environment, 

function checkEorXCtHjef) I 
var chk_flag * false; 

try f 

cbk_flag = (system, files ^fileExiatsAtPath ^ 

{■/Developer/Appiicatlons/Xcode.app*) “ true): 

J catch (e) {) 

If (lchk_flag) I 

tny. result .type =■ ‘Fatal*: 

my.result.title = 'XCode Rot Tnetalled'; 

my,resultruessage ” ^ 

'The installer requires the XCode environment to be 
installed.': 

I 

return chk_flag; 

1 


Listing 2 shows a second example of a disuiliution script. 
This one is commonly used to perfomi a VolumeCheck. 

The scTipt checks to see if the target volume has a 
maximum capacity of less than or equal to 256 Mliytes. If die 
volume meets the size condition, the script returns a TRUE. lf‘ it 
returns a FALSE, a slop Ixidge is displayed on the disk icon ft)r 
that volume. 

Listing 2. Filtering out volumes 
less than 256 MB. 

ftinction flltccStiiiillVoluiccs () 

I 

var test_flag = false; 

var test_liiQit = 256 * 1024 ' 1024; 

var test_size = 0; 

try 

I 

test_size = tiy . targeT.avallableKllohyTes: 

test^flag = (test_size Imit): 

syatnin.log('filterSaallVolumes:alze;* + teat_aisa): 

I 

catch (e) 

I 

system.IDg(e.name); 
system.1og( e .messa ge); 

I 

if {!test_fiag) 

[ 

my.result.type “ ‘Fatal*; 
my,result.title - 
my.reeulr.mesaage = 

1 

return (test_flag); 

I 

A ilikd example of a distribution script is shown in Luiting 
3. Tills example shows how a st'ripl t:an perfonn a device check. 

'fhe stTipt uses the lORegislry to see if a specific USB device 
is installed on die target platfonii. In this example, the device 
happeas to be a Macally graphics tablet. If the tablet is installed, 
die script reairn.s a TRUE. Otherwise, it anurns a FALSE, and 
displays a warning dialog to the user. Unlike Listing 1, the .stTipl 
dcK\s not terminate the insrallation process after the aser replies 
to the dialog. 
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Listing 3* Checking for a USB graphics tablet. 

fu BC tion c he c kTab1e10 

I 

var chk_flag - falsei 

// perform the hardware cheek 

try 

I 

var chk_tesl “ 

syatem.loreftiatry.frottPath{*iOService:/HacRISC2PE ^ 

7pcief2000000/AppleHacRlficPCI/usb«lB/ApplGlfSBMnT 

-1 

/MaciHy Mini fablet^lblOOOOQ*): 
chk flag ' (c;hk_resf !* null)? 

I 

catch Ce) 

I 

// handle the resiiltinj; excepebn 
my. result .type *- FataT ; 
ray. result,title - e.namp.; 
my .result.raeasage * e.roessager 

J 

// was tlic check successful? 

If (ichk_flag) 

my.result,type “ 'Warning*: 
my .result,title *No graphics tablet*: 
my.result.raeEftege " *The software being installed 
requires a "> 

graphics tablet for the best user experience.*: 

1 

return (cbk_fiag): 

1 

Finally, Listing 4 is an example of a script that will interact 
with an installation choice. This script Is used by entering its 
name inuj the visible field of the Scripts Ibtbox (Figure 
13) of tlic Choice Settings panel 

The script takes a single input argtiment named univbinary. 
It ftrst c:het:k.s to see if the current system version is less than 10.4. 
Next, it ciiciks univBinarv' to see if it is .set to TRUE, if this is case, 
tile payload is a Univei^al Binary, and die variatile ehk_ppc is 
then inverted. Ihe script then returns tlie final state of chk_ppc. 

Listing 4* Selecting an installation choice- 

function sysCheckCunivBlnary) 

( 

uflr cbk_ppr - falwe: 
try I 

cbk_ppG = (system.version.ProductVersion < '10.4*); 

If (univtiltiiiry) chk^ppe = !chk_ppe; 

) catch (e) (1 

return chk_ppc: 

1 


! Scripts: 

! H4mt 

( Start. Mlcct«d 

I stait.«nabl«d 
slait.^sibit 
^ wtmeted 
I enabt«d 
{ visible 

i 

I i Samplts 


Figure 13. Selecting a choice. 


Concluding Remarks 

The PaerkageMaker fool ts used to prepare software 
products for installation. This tool is available free from 
Apple as part of its Xcode development environment. It 
builds an installer package that is localaed for different 
languages. It also u.ses scripts to enhance the installation 
process. 

The latest version of the tool now supports the 
distribution package format, 'fhls new format is the 
preferred approach for handling multiple payloads on 
MacOS X 10.4 and newer. It Ls easier to localize, and allows 
insialhiiion choices to be customixed. It also adopts 
JavaScript as its scripting language. This enables its scripts to 
interact with the installer interface, and makes the scripus 
ea.sier to maintain. 

The distril>ution package is the preferred format for 
installing multiple software payloads. Though it has .some 
issues, it is still easier to localize compared to a 
melapackage. It alk>ws multiple installation choices to be 
customized, and it simplifies the assignment of payloads to 
each choice. The package format also uses JavaScript as its 
scripting language. This allows the scripts to interact with 
the user interface, and perform tasks that are difficult tt^ do 
using either shell or Perl, 

The examples shown in this article are part of the 
DGmoBistrlbutlon project. This project, togeUier with its 
payloads, can be downloaded from the MacTech website at the 
folkiwing URL: -place URL hertx 
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Mac In The Shell 


by Edward Marczak 


I Heart vi 


Text editing 

in a sheii 

___y 


Introduction 

tt’s aniiizing tiiat a Ixisic function like text editing am Ix’ 
so-**obruse. vi and emacs liave confounded new useD> since 
they arrived on the scene. However, editing text is such an 
iiitfiortant part of any Unix or Unix-like system* that Td be remiss 
if 1 didn’t address it. 'litis month, 111 cover basic vi - entnigh lo 
make you comfortable the next lime yoiiVe ssh-cx.! into a remote 
machine and need to edit a file. 

Growing Up 

Practically each month, this cx^lumn asks you lo type .scKnetiiing 
into a text editor. Of txxirse, this can lx* Text Wrangler, SubHihaKdil 
or even DieaTTiwaiver or die XGxle IDE. But if you alteady have 
a shell or, only have the option of a shell* then an editor like 
vi, eniac^ or pitx) are your l^est options. I’m well awaa^ of ilie 
vi/emtcs dehiies. Hitiai>; is truly a Swiss Aniiy Knife {)f an 
application. Pertiajxs Ml cover it someday. However, tor some 
reason, I just dug into vi more, and h;ive stuck with it; 'fums out to 
have Ixx^n a useful ciioice. ff you've ever ncx-dcxl to alter [>rivileges 
for SLido users, you'll ntxe tliat tlte right’ wiiy to eciit the sudoeis file 
is l7y using visudo - Ixtsiailly, a stripped down version of vi. On 
other Unix systems* thems typically a vipw and vi group iipp. All 
three, by default, usc^ vi as the edifoi; Also, ever notice which editor 
you use when editing cmntabs with crontab -e? So, vi is very 
gcKxl to know - at laist the fiasics. 

Quick iinie secret lx.^fore we start: traditional vi is f>ietty 
much gone, and has Ix^en supplanted with tim, V] Improved. 
You'll note that vi is simply a link to vim: 


S Is -Id /usr/btri/vl* 

Irwxr xr X 1 root wheel 5 Jari IB 2006 /usr/bin/vi -> vim 

Irwxr xr X I root wheel 3 Jao IB 2006 /ujsr/bin/view ■> vim 

-rwxr-xr-x 1 root wheel 2060380 Dec 25 2005 /u&r/bin/vlm 

Irvxr-xr-x 1 root wheel 3 Jeti 18 2006 /usr/bin/vimdiff > vim 

- tvxr-xr'X 1 root Wheel 106S Dec 25 2005 /usr/bin/vimtucor 

-r-xr-xr-x 1 root wheel 3'i472 Dec 25 2005 /usr/bin/vis 


OS X vlO.4 ships with vim v6.2. You can dtiwnload the latest - 
version 7 - and eoinpile it up, as it compiles and runs cleanly 


under OS X However, there's no need to do that to follow this 
panicular column. 

The Tower That Ate People 

If youVe never used vi* we ll rake it step-liy-step. So, open up 
your favorite terminal app and get a -shelL You may i\s well stay in 
y<3ui' home directory, as wc’a: not going to make too much of a mess. 

To stait the editor, simply type vi, and you 11 be greeted willi 
a startup screen. Unlike Word or Pages, you can't simply scan 
typing. Widl, you cmi, but each keystroke may not do what you 
expcci. llitxse of us tliat go back to Mac OS 9 will rememter 
modal dialogs. Basically, a miKlal tiialog lx)x stopfKxi you from 
using anything else until you acknowledged it. You were put in 
the iiuxle of having to deal witli whatever mess:tge it presented, 
vr is a modal editor You'll either be in one of three mixles: normal 
mtxle, 'edit' imxle, or ex ct>mmLm<.l rntMie. What ytfu're looking at 
now is nomial mode: vi awaits your instruction. 

Press i. Now, I should tell you here that c*ommands in vi arc 
arse sensitive, lypirally, ilu? lowercase version meaas one tiling, 
and the uppercase/sliifteLl verskin negates, or i.s the opposite of the 
k)WLT oase (or, non-shift) veision - this makes ctimmands a litde 
easier to remembtT. So, ycxiVt: pre.sstrd i, anil you now see "— 
INSERT —at the IxHlom of llie window. Cheat! Your first vi 
command. No sweat, riglit'/ Now you're in insert mfHle. This is 
pietty much what you exjxxl. Go alicad* type. How about we all 
type the s;inie thing. We’ll start otU ai-sy; try this, jriessing return at 
I he end of cadi line, mislakc^ and all: 

trust a fptf people 
love all 

do wrong to none 

Not t(X) terrible, right? ITessing iht: esea/K* key on your 
keylKXiRl w'ill pul you l>ack in normal mode. The — INSERT 
—“ .shimld dLsap|>ear. 

Now, I didn't get the Cjunte <|uite rigiii. let's fix it. Apple has 
nictly mapfxtl musA keys s;mely; I hey do what you exfxct. 'Hits 
indudes the arrow keys. I low'twer, this riKiy not lx- the aise on all 
systems, so, il' you’d like to get used to the vim w-iiy, HI show you 
nt)\v. “Hi is will also Itelp your Netliack skills (http:/A aavw. nEthad.org). 
k is i\ii:sor up, j Ls eursor down, svhile li moves the cursor left, anil 
1 moves it right, tA^rhaps not tlie eask^i lo nniemIxT. DiJ'feient 
people hive different vMiys lo n!memlx.T ihis, but, I sim[>ly suggest 
a Post-it note and some practice. WJiy ihesc keys? Vim and vi .strive 
lo lie elTident txiilors. I love to use* vi as I never have to take my 
hands off of the keyixxtrd. nor ‘Sray t(X) far from the liome row. 
Ufats efficiency. If yoifre KJ0% MiiCHledicaled, tlxiugh, the amm^ 
keys will suit you fine, ux>. Digjesston aside, pleiise move the 
cursor to the first character, tlie T in 'tnist'. 

Wen* if riiars the [beginning of a semence, it slMJuki lx.‘ uplxncxuse. 
Hktc’s two wiiys to tackle this, and we'll start witli the easier of the 
two. Witli tlie aiisor on tlie X\ press(tilde), 'iliis tqggles the 
diaracter under tlie cursor lietween upper and lower<a?ic^ and tlien 
advances tlie airson All, hut wait, dial s not the coimt lx:giniiing of 
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lhal t|U(j(d Witli your ojrsor on that line, type dd, vvhidi will delete 
liie line and place it in the buffer. Now, ptess p which pastes 
the contents of the yank buffer on die line following. 

Now, our aitiital letter leads the second sentena^, which natuMy 
LstVi right. Twiddle it I'KR'k using the tikk: key Cunxjr li[i and onto 
die T in 'love’, and well leiilace it witli an uppetrase version - tliis 
lime, ihougli we’ll do just tiiat: replaa^. l>pe followed liy 'L'. r will 
replace one charactcT So, w'hen yai typed iIk‘ V, you siiiijily lepkiced 
what wits there, 'lime for die correct punctuation. 

With the cursor still on the first line, type A, for append to 
end of line' (niake sure ifs opkal A!). Your cursor will jump to 
the end of the line and ytJtill enter insert mode - look for the 
INSFRT message in the status line. Type a comma, and 
press escape to get back into normal mcxle. 

Cursor dowm to the second line, and then right to the p’ in 
■people'. Delete, one charactcT at a time using the x command, 
the word 'people', Iiul leave the space after Tew'\ Replace tlie 
space with a comma, using r, followed liy a cotnma. At this 
point, you should have: 

Love all * 
trust a fev. 
do wrong to nom 


...with your cursor on the comma alter Curst>r down to 

the third line and type $ - jump to the end of the current line, 
Rr\ss a Uhe letter “a ) - afijKmd after the cursor - and type a 
(perkxl). (Those of you paying attention will realize ifiat this 
could have lx?en done in one step with capiird A...hut how else 
was I CO stick in the S c'OJiitnand to jump to the end of a line?) 
Press escape lo go iiack to iu>riiial mode. 


Cursor up to the first line and press J (capital )>. 'finis will 
Join this line with the one following. Do it again, and you’ll end 
up with one single line: 

Love all, trust a few, do wrong to none. 


And Through The Wire 


So, now^ ytxi have tlie very' basics of editing with \t \ iTXfntioned 
diat vi Ix-gat vinij but 1 didn’t yet teU you that ex Ix^tt vi 'fhe 
founcLttion of certain comirumds arc ex amtnuitids. You enter ex 
command mtxkL liy typing a colon You'll see a a>!on appear on 
the sialiLS line, and tlie airsor will jump down to initiiediately follow 
it. w ws. txt. ’w' Ls for 'write', and will write ihe tile 'ws txi'. 

If you need to take a break, you cTtn type :q to quit. Re¬ 
enter vi while loading tlie file like lliLs: vi ws.txt. 

WeVe kx>ked at three w ays to get into iasett iiKxle so far: 1‘, 
foi’ insert in place, 'a' for append at the cursor and 'A', w^hich 
Uplands at die end of dte current line. I lere's one more: o. Tim 
o\ycns d new line l>eneath the cuitent line. Try* it now. 

Don’t forget! vi inherits all of the integration that using 
'I'ermtnal.app brings OS X users. The best is drag-and-drop. 
While in insert mode, you can pick up a text or c lipping hie and 
drop it on the terttiinal, 'Hie conteni.s will insert at the cursor. 



Name 

/usr/shtfi/kadmln -r XTC^UDI.1 
# mdutd -k off /-/— a«xtC| 
S /Svsiem/Ubrarv/Frameworks.! 




Figure 1: Dragging a .dipping file to TerminaLapp 
while editing in vi 
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Try it now, while youVe still in insert mode! 

At this point, I encourage you quit vi - ;q - and type 
vimtutor. Its an interactive vi tutorial that takes about 15-20 
minuies. Gocxl, basic pmctice and tips. 

More Than This 

vimtutor does a gfK>d job of covering the ha.slcs. Let me 
wrap up witii st)me ut iny favorites dial neither I or vimtutor 
have inirociucecl you to. 

:,shell ~ this ex command lets yt)u escape to a shell, do your 
work, and then when you exit, you 11 find yourself right where 
you left off. Now. ceitainly, this function has lost some value in 
the days of multi-window machines, but soincLiiucs, its really 
handy. It let's you gel a lay of the land, and then pick up right 
from where you left off 

vimtutor shows you liow to run an external shell 
command, but at Ume.s. there’s even something more useful: 
running a coitiinand and iitserting it,s output at die cursor. To 
preface this, you am raid in a file using the r ex eonnmnd. 
You can even read in the file you're working on. Try it now with 
: r ws . txt. You1l see the contents of the file - as it is on disk 
- appear inserted into your file aftvs your cursor. Similarly, you 
can read in the output of a .shell command with r !. lasert aU 
of the users froiti Directory^ Services into your file with: 

Idacl iQcaltioflt llfit /Search/lfsers 

Tills comes in handy. Instead of running a command, 
redirecting output to a file and then editing that file, you can do 
it ill one step in vi. 

vimtutor also slums you how to .strairh using the / nonnal 
t:ommiind. If you didn1 am tlirotigh viintuuir. do it now. Really. 
Here’s two diings tliey- didn’t gv^t into fully. Ijoad up vimtutor. as it 
piovicles ample text for its ((juii ytHir tiirrent session widi and 
then type vimtutor at the sliell pitHiqx). Ptit the cursor on the first 
€x:airrence of die word ^’commands''. You .should see .several of 
than. Press * (asterisk), vi automaticiiily starts scaiciiing on diat 
w'ord, and jumps to die next tjcainrentc*. You can jump lietween 
(Kiurrences widi n and N, ii jumping to the nt:xi (forward) 
(X-Xtirrence, and N jumping bit kward 

Anyone familiar willi sed will feel riglil at home widi viin's 
.search and replace fiinaion. vimtutor showed you .searching 
with /. Search and replace is accomplished with :% 
s/old/new/g. The rcprc.seiits the entire file. ’Without it. 
youVe only searching the current line. Additionally the Vg” means 
ghiMil, and without that llag. only the firsi tHX'UiTencc on eiich line 
would lie replaced You can also usc‘ the c flag lo have vi a.sk for 
a confirmation. Go to the top of tlie file and try diLs: 

s/cojfflnands/friendK/ge 

All (KTiirrences t>f \:ommands" will f)c changed to “friends'' and 
youII lx: asked for coiifimiatioii of each change. You may 
notice that this substitution works surprisingly well! 

Finally, one option 1 use quite often: changing line 
endings, .Since a file is just a stream of bytes, the computer 
needs some way to recognize when humans warn to ,sce a 
new line. Unfortunately, the three majt>r platforms all 


WmV.MACTtCK.COM 












CodeMeter 


■ Highest Security 

■ Vendor selectable secret and private key 

■ Strong encryption algorithms with AES 128 bit and ECC 224 bit 

■ Best-in-class tools for automatic protection (envelope, no source modification) 
for Win32, Win64, .NET, Java and MacOS X Universal (PPC, Intel) 


■ Best Flexibility 


The very highest quality by WI8U-SYSTEMSI 
Mare than 3000 applications developets and creators of 
intellectual property trust in WIBU-SYSTEMS 



Order your Free Software Development Kit now 
Phone 1-800-6-GO*WIBU | order@wibu.us 


■ More than 1000 independent licenses can be protected by one CM-Stick 

■ One versatile hardware key for all license models including floating network licenses 

■ Multi-platform support including Windows, MacOS X and Linux 

■ New Distribution Channels 

■ License transfer by SOAP based CM-Talk or file based Field Activation Service in eShops 

■ Multiple purpose, including protecting low cost software and also content 

■ Unique End User Advantages 

■ First and smallest dongle with up to 2 Gbyte Flash Disk 

■ No drivers necessary - can be used without admin rights 

■ CM Password Manager, secure virtual drive and secure login 


solutions since 1989, 



■KiiiiisMiriari 



//CODiE// 

//CDDiE// 



1 FINALIST ■ 

■ FINALIST ■ 




2005: Best Digital 2006: Best Security 

Rights Management Software 

Solution: Software 


UIBU 

SYSTEMS 


WIBU-SYSTEMS USA InC. 
2429 NW 197rh Street 
Shoreline. WA 98177, USA 
www.wibu.com 
Tel: 1-206-546-4891 
Fax:1-206-237-2644 



















deckled on different ways. Unix and Unix-like systems use 
a line-feed characi.er (IF), ascii OxOA. DOS uses iK)lh a new 
line (NL, or carriage retLirn CR) mid line feed. When DOS 
sees CRLF, ascii dxOD OxOA, it knows to show us humans a 
new line. Finally, Mac systems tradirionally have used a new 
line only. The current state of line endings under OS X is a 
bit of a mish-mash. Most GUI apps still use CR, where most 
(if not all) shell apps use LF. 

Many times, you’ll receive a DOS line-ending-formatted file 
that should Iiave Unix line endings, vi handles this with aplomb. 
Use : set ff=ynix and then write the file with ;w. Done! Go 
the other way wkli i set f f-dos. SomcLimes this shows up 
as AM (ctrbM) characters - that’s the extra CR character Just 
change the file type and write it out. 

Don’t Give Up 

vi is a craftsman’s lfx>l. like any tool, it requires a iiitle 
w'ork and practice to learn in depth, or to make second nature. 
1 hope next time that yoifre into a remote system and need to 
edit a file, or for some reason are forced to u.se vt, that you’ll he 
confident in your usage. In tfie spirii of self exploration, Utke a 
look at ail of die settings that can Ix" dianged to tailor vi to your 
style by trying :seL all. 

Fie aware that there Ls a GUI versitm of vim availal^le at 
<hl:tp://mvwinacvim.ofg>. It may not lx a GUI app die w^ay you 
think of one, but it is integrated with the Aqua environment. 


Frankly, though, I never really saw the pt)inL in Xll or GUI 
versions of vi or emacs. In tliose environments, you’ll have 
access to a shell, so why not use it as intended? 

Media of the month: Up, by Peter Gabriel. A masterpiece. 
Seriously. If, for some reust>n, that doesn’t do it for you, just 
take some time to put on some headphones (real cans, not 
those iPod things), lay down, and really listen to some music. 

See everyone next month at MacWorld, 1 hope! Fm 
presenting two sessions, and will be hanging around the 
Maclech booth, so please make sure you stop by and say hello! 
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Xsan, Part 2: 
Planning Your 
SAN 

By Paul T. Ammann 


Introduction 

In Xsiin Part 1,1 introduced you to Apple's Xsan and gave you 
an overview of SAN tec hnology. Hopefully that article answered 
the “What Ls a SAN, aiKl why would I want i>ne?" (|itesiion. 

In this article, we continue the km by planning your SAN. I'll 
ftKiJS more on the hardware, planning considerations, and 
plaimittg tiisks. There's a lot of grtnmd to cover, so let's get started. 

it's easy to add storage to an existing Xsan SAN, hui 
reorganizing a SAN after you set it up is not so simple. So, it's 
important to plan ilie layoui ami oiganizjrtion of your SAN and 
its stomge luTore you set it up. 

An Xs;m SAN is coinpoa^d of: 

■ Storage devices (usually Xserv-e RAID systems) 

• LUNs (logiail unit numbers, usually RAID arrays) 

■ Storage pcx^ls (groups of LUNs) 

• Vt>!uines (groups of storage pools visible to users) 

• Clients (computers that use volumes) 

• Controllers (ciompuiers that manage volume metadata) 

• Underlying Fibre Channel and Rihernet netu'orks 

IHort* ycHi U.SC Xsan Admin to set up a SAN, decide liow‘ you 
want to oiganize tliese oiriiponenLs. Take the lin^f to cix^ite a drawing 
or a table that otg^inizt^ uvailal Je liaidw'are into RAID airays, stonigt: 
ptxds, volumes, client cx^mputers, and conm)Ilers in a way tbit meets 
lx)ih your u,seis’ needs and your needs as the SAN adniinistnitor. 
Then, consider llie following questions. 

Preliminary Planning Questions 

• How mucli storage do you need? 

• How do you wan! to pre^sent available storage to users? 

• What storage oiganizaikm makes ihe most sense for user 
workflow? 

• What levels of performance do your users require? 

• How imponani is I'onstant availability? 

• What are your requirements for security? 


Your answers to the above questions will help you decide 
the following: 

• What RAID schemes should you use for your RAID arrays? 

• How many SAN volumes do you need? 

• Mow should individual volumes l>e organized? 

• Which LUNs go in each storage pool? 

• Whicfi storage p<K3ls make up each volume? 

• Which clients, users, and groups should have access to each 

volume? 

• Wliich computers will act as controllers? 

• Do you need standi>y controllers? 

■ Do you want to use controllers as clients also? 

• Whem do you want to store file system metudaui and journal data? 

• Wliat alltK-alLion strategy should you use? 

Let's review the consideration and guidelines for help in 
iranslating your aaswers into a suitable SAN design. 

Planning Considerations 

The lollowing sections shoukl help you make some of your 
SAN design decisions. 

How Much Storage? 

because it's easy to add sioragc lo an Xsan SAN, you only 
need to tiecide on an adequate starting point. You can tlien add 
storage ftjr user data as needetl. 

You can't expand a storage pool that is used to store 
volume metadata and journal data, In “Estimating Metadata and 
Journal Data Storage Need,s,'' we'll cjcamine how to estimate 
your metadata and jtjurnal data stf^nige recfuirements. 

Note that the nuiTil>er of Xserve RAI[> systems you use 
affects not oniy available space but also SAN tx^rformance. I'll 
gel to performance ct>nsidemtions in a moment. 

How Should Users See Available Storage? 

If you warn the users working on a particular project to see 
a volume dec!irated to their work, crciile a separate volume fiir 
eac h project, if il's acceptable for a user to see a ftdder for his 
or lier work an a volume with other people's folders, you can 
create a .single volume and organize il into projed folders. 

Workflow Considerations 

iiow' niudi Hie sharing Ls leciuiied by your users' workflow? If’ 
for example, different iisen^ or grouj^s work vn tile sanx files, either 
simultaneously or in sequence, it makes sense to .store tliose files on 
a single volume lo avoid having to mainiain or hand off copie.s, Xsan 
uses file kxking to manage sliaied acx.es.s to a .single copy of tite files. 

Performance Considerations 

If your SAN supports an appliouitm (such as high 
resolution video capture and play[>ack) that requires die fastest 
possible sustained data uansfers, design your SAN with these 
performiince consideralions in mind: 
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• Ser up tht; lAINs (RAID arrays) usin^ a RAID sclicuic liiat 
offers high pcrfoniiance. This is covered in “Choosing MID 
Jkrhemes for LLlNs." 

• Group your fastest lAINs in storage pt)ols reserved for the 
application. Resei^e slower devices for a volume dedicated 
to less demanding or soppoiting applications. 

• To increase panillelism, spread LUNs across dilTcrent Xserve 
RAID conirollcTs. For cxiunple, instead of creating a single 4<lLsk 
LUN on one side of an Xserve RAID, create Wo 2-disk LUNs, 
one on eacfi side, anti atkl these LUNs to a stoi^age |XK)1. Xsan 
then stripes datii iiaxm die two LUNs and benefits from 
simultaneous transfers through two controllers. 

• 'tb increase parallelism in a relatively small storage pool (tiie 
si^e of one or a few drive mexiules), cremate a slice of similar 
size across all the drives on a controller instead of creating 
the storage pcx)l from just one or two drive modules. 

• Spread file transfers across as many drives and RAID controllers 
a,s |x>,s,sible. Try aeating slices across the drives in RAID 
systems, and then combine these slices into a storage pexd. 

• To increase throughput, connect lK)Lh p^irLs on client Fibre 

Ciiannci cards to the fabric and set the multipathing method 
for the storage pool to Rotate. 

• Store file system metadata 
and journal data on a 
separate storage pool 
from user data, and make 
suft' the metadata LUNs 
are not on the .same RAID 
controller as any user 
data LUNs. 

• Use a njuler to isolate 

the Ethernet network 
used by the SAN from a 
company intranet or the 
Internet, or better, u,se a 
second Fthernet 

network (including a 
second El her net cad in 
each SAN computer) for 
the SAN. 

• If your SAN uses directory 
services, tiiail services, or 
other services on a separate seiver, use a second, separate 
Ethemci network to conncx:i SAN ccjmputei's to that sender. 

• As a nile of thumb, consiLlej^ tliui a single Xserve RAIL) 
controller, after tile system overhead, can transfer roughly 80 
ME of user ikiii [x:r second (160 MB per Xserve RAID system). 
If your SAN mtist support an application niniiing on multiple 
clients that requires specific throughput on each client, you cm 
use this number to estimate the nu nilxir of Xserve RAID systems 
necessaiy' to support die aggregate tiansfer rate. 

Availability Considerations 

If high availability is ini porta nt for your data, set up at least 

one standby controller in addition to your primary controller 


Also, consider setting up dual Fibre Channel connealons 
l:>erween each client, controller, and storage device using 
redundant Fibre Channel switdies. 

Important Losing a metadata contiotler wirhout a standby 
can result in the loss of all data on a volume. A standby 
contrc^ller is recommended. 

Also, if you have a standby controller you c'an upgrade the 
Xsan software without internipting the SAN. 

Security Considerations 

If your SAN will suppou projects thai need lo he 
completely .secure and i.solaled from each other, you can 
create separate volumes for each project to eUminate any 
possibility of the wrong client or user accessing files stored 
on a volume. 

As the -SAN admini.stralor, you control which client 
computers can use a volume. Clients can’t browse for or mount 
SAN volumes on their own- You use Xsan Admin to .specify 
whicli dieni.s a volume is mounted on. 

You can also set up access control lists (ACLs) in Workgroup 
Manager or assign user and group permissions to folders using 
standard acc:ess permission.s in the Finder. 

Choosing RAID 
Schemes for LUNs 


Much of the reliability 
and recovembility of data on 
a SAN is not [:)rovided by 
Xsan itself hui by the RAID 
arrays you combine to create 
your storage pools and 
volumes. Before you set up a 
SAN, you use the RAID 
Admin application to 
[prepare LUNs leased on 
specific ILAII) schemes. 

Important: If a LUN 
belonging to an X.san 
volume fails and can’t be 
recovered, all data on the 
volume is kjst. It is strongly 
recommended iliat you use only redundant LUNs (LUNs 
based on RAID schemes otlier than RAID 0) to create your 
Xsan volumes. 

LUNs configured as RAID 0 arrays (stripping only) or 
LUNs ba.secl on single drives are difficult or impossible to 
recover if they fail, Unprotected LUNs such a.s these should 
only be used for volumes dial contain scTatch files or other 
dam that you can afford to lose. 

Xserve RAID systems ship already configured as 
recoverable RAID 1 arrays. 

Xserve RAID supports all popular RAID levels. Each RAID 
scheme offers a different balance of performance, data 
protection, and storage efficiency, as summarized in Tal>lc 1. 


RAID Level 

.Storage 

Fificiency 

Read 

Performance 

Write 

Performance 

j Data 

Redundancy 

RAID 0 

Highest 

Very High 

Higlic.st 

No 

R^AID 1 

Low 

High 

Medium 

Yes 

MID 3 

High to 
very high 

Medium 

Medium 

Ye.s 

RAID 5 

High to 
very liigh 

High 

Higli 

Yes 

ILAID 0+1 

Low 

High 

High 

Yes 


Table L 
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RAID It), 30, and 50 schemes assLime the use of 
AppleRAlE) softw^are striping and aren't appropriale for 
use with Xsan, whicli perfomis iLs own striping. 

Deciding on the Number of Volumes 

A voiuiiie is I he laigest unit t>f sliared sit jragc on tlie SAN. 
If your users need sliiin:xl access to files, you should store 
those files on the same volume, litis miikes it unnecessary for 
diem to pass copies of the fifes among tfiemselves. 

On the other hand, if sccLirity is critical, one way to 
control client access is to create separate volumes and 
mount only the authorized volume on each cUenL 

For a more typical balance t)f security and sliared 
access, a Oexible compromise is to create a single volume 
and use folder access privileges or access control lists in 
Mac OS X Server s Workgroup Manager to control acce.ss. 

Deciding How to Organize a Volume 

You can help users organize cktta on a volume or 
resirtci users to specific areas of tlie volume by creating 
predefined folders. You c’-an control access to these folders 
by assigning access permissions using Xsan Admin. 

You can a.ssign folders to specific storage pt)uls 
usitig affinities. You can, for exampiu; create a folder for 
data that requires fast access and assign that folder to 
your fastest storage pool. 

Assigning LUNs to Storage Pools 

You shoukl set tip a storage pool using UJNs that 
have .similar capacity and perfunuance characteristics. 


To provide high performance, Xsan uses liie RAID 0 
scheme to .strif>e data across die LUNs in a storage ptx)l. 'I'his 
requiie^s ifuu the LUNs in the pool lx? the same size. If you 
set up a storage pool tising LUNs of different sizes, Xsan 
uses available space on eadl LUN ecjual to the capacity^ of 
die smallest LUN. If the LUNs vary in size, diis can result in 
wasted c'apacity. For example, if you assign 24Q CiH and 3b0 
GH RAID arrays la a storage p<x)l, 120 GB of the laiger anay 
will not Ix’ used. By combining LLINs w'itli similar capacities, 
you avoid w^asting available storage. 

If you want to set up a storage pool Ibr use by a high 
performance application, assign similarly high speed LUNs. 
Assign slower LUNs to a storage pcxil where you keep cbita 
that doesn't liave crittal performance! recjuiiemenis. 

Creating storage ptK)ls frenn LUNs tliat are hosted on 
different drive modules and different ItAlD controllers 
increases performance by increasing tlie parallelt.sm of 
data transfers, Fcjr example, a steerage ptxil consisung of 
two LUNs, each a single drive mod tile on the left side of 
an Xserve lUVlD, wall not be as fast as a similarly .sized 
storage ptxil made up of two LlIN.s tluti are single slices 
across all seven drives, one slice an each controller. In the 
first case, all transfers go through a single RAID controller 
to just two drives^ iii the .secr>nd case the .same transfer is 
spread across iwi) RAID coni rollers and fourteen drives. 

Assigning Storage Pools to Volumes 

After you decide liow to tromt>inc availat:)le LLJN.s into 
sttjrage ptx)ls, itssign the storage pools to tiie volumes you 
w'ant to aeate. 












For best perforEiiance, create a separate stt>rage pcxil 
just for file sysretii metadata and journal data. 

Dccidiiig Wliicii Clients to Mount a Volume On 

If you create multiple volumes, deckle wliicli 
volumes should he mounted on which clients. For 
example, you might liavc one volume for Finance, 
another volume for Executives, and another volume for 
Executive As.sisiants. 

ChcK>sing Controllers 

You must choo.se at least one computer to be the SAN 
coiUroHei; the compuier that is responsible for managing 
file system metadata. 

Note: File .system metadata and ioiinial data aie stored 
on the SAN volume, not on the controller Itself. 

If you have a small number of clients or if 
performance is not critical you can use a sirtgle 
computer as both controllers and client. You can event 
set up a SAN consisting of a single storage device and 
a single computer that acts as both controller and 
client (U) provide nelw'ork attached storage, for 
example). 

rf high availability is important, you should use at 
least iwx> cxinirollers, one as the primary controller and 
one as a standby. You can specify additional 
controllers as needed, and set their failover priorities to 
determine the order In which they are tried if the 
primary controller stops responding. fHd. Note - More 
than for simple high atmilahiliiy, a re dun da nt 
metadata con trot ter is criticai for many retisonSf data 
protection not being tbe least Don*t even 
contemplate setting up XSan wilhoui two dedicated 
metadata controUersJ 

If j^eifonnance is critical, don't mn other server seivlces 
on the metadata controller and don't use tlie conlroller itself 
lo leshare a SAN volume using AFF or NFS. 

Choosing Standby Controllers 

To be sure that SAJM vDhime.s are always available, set 
up at least one standby controller that can take over if 
your primary meUidaui conlroller fails. A standby 
(ontroller ;ilso makes it possible for yc^u to upgriidc 
software on the controllers wathout interrupting user 
access lo SAN volumes. 

Combining Clients and Controllers 

The same computer can function as both a 
metadata controller and a client. Il\s possible, for 
example, to set up a SAN consisting of a single Xserve 
RAID anti one computer that acts as both controller 
and client. Any computer you specify as a controller 
can also act as a client. 

[f, for example, you don't have a computer to 
dedicate as a sumdby controller, you can assign a 
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cuinputer that Ls normally used as a client to take over 
controller duties if the primary controlier fails. 

To keep c?l tents and controllers separate, you can set 
up clieni-tMily computers for your users* 

Choosing Where to Store 
Metadata and Journal Data 

The metadata and journal data that descril^e a 
volume are not stored on the volume's metadata 
cxjniroller hui on the volume itself. By default, they are 
stored on the first storage pool in the volume* If I he 
volume consists of more than one storage pool, you 
can choose whicli storage pool is used to store 
metadata and journal data. 

In most cases, storing metadata and journal data on 
ihe same storage ptjol as user data results in adequate 
performance* However, for the best possible 
performance, store metadata and journal data on a 
separate storage pool within the vt?lume and make 
sure that llte LUNs used are connected to a different 
RAID controller than the LUNs that make up user data 
storage pools* 

Estimating Metadata and 
Journal Data Storage Needs 

'fo estimate the amount of space required for Xsan 
volume metadata, assume that 10 million tiles on a 
vt)lyme require approxhnately 10 gigabytes of meiadaia 
on the voltimers metadaia *storage pcx>l* 


Choosing an Allocation Strategy 

The allocanon stnitegy you choexse for a volume 
determines the order in whicli its storage pools are 
niled with data. You can choose round robin, fill, or 
balance. 

If you choose round robin, Xsan writes new data in 
turn to cTctch storage pool in the volume. 

If you choose filf Xsan w rites all new data to the first 
storage pool in the volume until dial storage pool is full, 
and then moves to ilie next storage pool. 'Lhls is a good 
choice if you want to keep a particular storage pool 
unused as long as possible* 

If you c‘h(K)se balance, Xsan writes new data to the 
siomge pCKil witli die most free space. 

Summary 

In ckxsing tills article, 1 hope I have covered enough 
topics to assist you in your planning considentiions for a 
SAN. SANs have many Ixmefits, but careful planning is 
needed Ixrftxe selling one up. 
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Rvew so often^ ^ try to write iirtic:le.s that c:onlain 
practioil help. The nolicKi to write Uiis column came, wlieo 
I was processing data from one of the logs created by my 
Web server The referrer log tells me the last port of c:all 
made by a visiting surfer; it records the page that a visitor 
was reading when they clicked a hyperlink to access one 
of my pages or images. I can find ovit who has links to my 
pages, and how olten those links are exercised. The log has 
one line per record and three fields per line: the .sc^iirce 
LIllL, an arrow (in the form of ->), and the destination page 
or linage. Each field is separated by while space, and so 
can easily be processed with standaixl UNIX tools. 

There are several c[uestions that 1 like to ask about 
this data. What pages are most fretjuentJy used to link to 
my pages? Which pages are most frequently accessed 
from outside? Are there any surprise entry points that 
people have linked to? Is anyone linking directly to an 
image? 1 do think that it’s bad manners to incorporate 
other people's images in your pages^ unless you inform 
and a.sk ihe originator. On the whole, I don't mind people 
using my images, as long as, proper credit is given, and 
others are not passing off my work as iheir own. 

Using awk 

I haven’t created any .specific shell scripts to proc ess the 
refener log data. 1 usually ly|x^ ihe lines that I need into the 
shell to obtain the result I am looking for. The questions 
alx)ve mean that I will Ix^ jircKessing one or otlier of the 
space-sepanited data columns fnm the file, and I need .some 
way of selecting the aj>prxjpriate data. Tlie tex)! that I always 
use to select one coliinin from a file is awk. For exattiple, the 
command 

$ avk ■(print $3}' log 

will print column three of the source file log on the 
standard output of the cotnmand. This column hcjlds the 
target jjage addresses in the referrer log. The awk 
program in braces is quoted with single quotes so that die 
dollar c’haracier is not expanded i)y the shell. Using 
quotes is a gtxxl habit to gel into, for awk or sed 
programs typed on the command line. 

I find that 1 use the column selection facilities of awk 
more frequently than any of its other commands* The 
column select format is easy to remember, and is useful in 
many circumstances, i-or example, 

S awk ' (print log. 


can be used to filter die arrow out of the refener log and 
also swaps columns. 

The general form of an awk command is: 
selector fcomiiiands] 

The selector is apt^lied to all die lines tlial are read from 
the input data file, and if the selection succeeds, then the 
commands within the braces are executed. In the above 
examples, the selector is empty so the single command is 
applied to all the lines from the source file log. 

Actually, tecatise the awk command is picxessing a log 
file, ifs a g(xxl idea to fx suspiciuLis of die data. Sometimes 
log (iles are not written proiierly, or the dita is written onto 
them is not what you expecl* In diis c'ase, lieing suspicious 
paid off. It turns out dial some of the IJEIji wrilten In a>lunin 
one of the log contained emliedded spaces, meaning that 
rather than li^iving three columns on the file, there are 
.sometimes more* 1 used a small one-liner to determine this: 

$ awk ■NF (= 3 (print $0)' log 

Tlie command makes use of the selector field. The 
selector liem is a Ikiolean expie.ssion, testing die inliuilt awk 
variable NF tliLit liolds the nttmlier of fields that awk Ixis 
found in the input line. If the numlx^r of fields is not equal 
io three, then 1 print the whole line (?0). 1 then kxik at die 
output to see what the exceptions are, and quickly see the 
embedded spaces in die five or so lines diat are output* 

Howevei, htx^ause the extra .spaces are only in 
column one of the log, 1 can use an alternative procedure 
to obtain the last column* I1ie easiest way to pick off the 
last column in a file i.s U> use 

$ awk "(print $NF(" log 

liecau.se the NF variable is .set to the niimixr of fields on 
the input line, $NF will pick olf the last column on each line* 
Mowever, things are a little trickier if! want to accxirately pick 
off the fivsX column in the file. The command 

S awk ‘ (print $11 * log 

won’t work properly because the data that should be in 
column one is sometimes spread into two or iruire 
columns. It’s possilile to make awk do the right thing by 
sticking the columns together using a .sequence of 
commands that feed data Into the awk command* 

Flowever, life is itx) short and the answers to tlie 
questions that 1 ]>t>scd above are not materially affected 
by the slight inaccuracies cau.sed by cjccasional failure to 
pick up the complete URL from tradi line. So my 
judgment in this case Ls that using the $1 .select to pick 
off the first cohimn is good enough. 

The uniq Command 

Welf having selected die data, what next? 1 can look at 
the mw data, but that's tedious. It’s better to process it 
somehow lo reduce the amount of information that I need 
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to look tlircjugli. One obvioiLs w;iy of looking at tUita with 
replicated entnes is lo generate f)iitpiit tliat oniits duf^licates. 
Tlie uniq eornttiand can do tliis. 

llie uniq command is designed to oLitpiit exactly one 
instance of any lines that are repc^ued in its inpui stream, ,so 
simply using the raw conaiiaiKl as a lllier will ensure that we 
only see each data item once. However, T prefer to see 
oiitpiii tiiat contains the ckta, and tiie numlx.T of times ilrat 
a particular data item is repeated. When uniq is SLip[)lied 
with tlie —c switt'h, it will piinl a count of crac^h repeated line 
alc:>ng with ilie daut. So, if we have a data stream like 

one 

tvo 

two 

three 

three 

t h ree 


then uniq —c will print 

1 one 

2 two 

3 three 

coiinliiig the frecjuency that each repealed line occurs. 
However, to use this counting ability on raw data, we first 
need lo sort the data, so that all identical lines are next lo 
each other. Well type 

$ awk MprlfiL $NF} * | sort | uniq -c 


and will see the frequency counts and the tkita being 
output. 'File output from this command is still not as 
lielpful as it might l>e, so as a final touch, 1 will usually 
pass the data into the son command again. Tills time I will 
tell the command to sort numerically on the Tirsl field, the 
count, by supplying the -n switch. So, when typing t!ic 
line above, T11 usually ajipend 

... I aort -n 
or 

... I sort 'nr 

depending on how I want the output to be sorted. The 
fust variant of the cc>mmand will sort into ^iseending 
numerreal order, so the items with the most access 
lrec|uency will be printed last. 1 usually prefer the data to 
lx* soiled into descending hequency order, and use the r 
option to the sort command to reverse die order of ilie 
sort. It's often true to say dial the data of most interest is 
at the start and the end of the frequency spectrum. 

So, pixxessing column three of the relerrer log to 
generate a frequency list will answer some of my oiigiiial 
questioas, die queries alxiiit die taigcLs of other people^s 
links. 1 am ;ilso use grep to find out alxjut direci links to 
images from tlus output, and identify the source of the direct 
links lo images by kxiking through die original diua. 

To answer the other questions about the sourt:e of 
links, 111 need to look at column one of the log, the 
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source URL Wireii looking at column one of tlie data, it 
helps to know a little about 1JRL construction. If the visitor 
came to my pages fn>m a search engine, then l!jc 
arguments lo Ujc search are contained at the end of tlie 
URL, after a question mark. This can be helpful, 1 can 
deduce what people were looking for in the search 
engines, when they ended up at my pages. 

However, if 1 am examining the Rrsi ctJutim to deditce 
Uic mosx frequently used links u> my pages, I am not 
mteresttxl in llie seardi infonnation, I just want to see the Ijase 
URL. Tlie trick is to massage the ckta fixaii die log file liefore 
ifs frassed into sort, uniq, and sort —n. Simply deleting 
any data after a question mark will ensuie that only the URL 
is left fn>m liie st^urce data, so VW type .sometliing like: 

$ awk Mprint $lj* log [ sed -e | 

sort I uniq -c | sort -nr 

Here, the argument to sed deletes all data on any input 
line diat starts at a question mark, and extends to the end of 
the line. Using this pmpass technique to suppress or alter die 
ckita, there ate various other reflnemcnLs tliat I can make to 
give me die answers to other t|uesLions tliat I maiy ask. 

Using uniq -c and sort la olitain frecjiienty a)unis of 
data is apj>lititl>le in many situatioas, It\s a cf>mmon metiKxl 
to reduce inlbrmation to a form that allt>ws you to appreciate 
die mw data In a more meaningful way, I'or example, the du 
command generates to columns of data: a numlier rcialing to 
the di.sk (Kvupancy of the directory and the n;mie of the 
direaor>c You can .sort this output using sort —n, to give 
yourself a fel for what is liappeiiing on the file system. 


Mowc'vcr, lx:ware that die du cximmand prints sizes in 
kilobytes, Ihe trick liere Ls to use die —k switch to du. 

More on sort 

If you kxik at die manual page on your system, you'll 
find that die sort command kis several useful switches tliai 
can hcl[> you look at data in different ways. For exam]:>fe, the 
—f o|>tion treats lower- and upfiercase letters the .same for 
sorting, and can Ix" helpful if you want to Icxik at a dinectoiy 
using Is, placing files of similar names next to each other, 

$ Is I sort -f 

This command will revert to the t>riginal fomi of Is, 
giving you one file name per line. If you want a columnar 
lisiing, then puss the output from the aliovc command 
through pr, supplying the —t option to suppress headers: 

I pr t -6 

The -6 will give you six columns. My shell has an 
environment variable called COLUMNS iliat is set to the 
number of columns in the curreni windows, so 

1 pr ’t '3 'W $COLUMNS 

will [irinl eight columns acras,s the width of die sc reen. You 
do not need to lx careful of the output from pr; it will 
imncate data that dexsn't fit into its pre’Computed column 
spacx, so filenames c'an appear shorter than they are. 

Of course, it's harder to son the OLitput of an Is —1 
command into case-tndej>endent name ortler, Ixcause the 
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output line^ have all the other file information, such as file 
pemiissions, owner identity, size, and so on. By default, if 
you jusl sling the data from Is —1 command into the sort 
program, then the whole line will be used as a key. and the 
output will probably not lx.* what you want. You need to 
tell ilie sort eomiiiand to use some pan of ihe input line 
its die sorting key. 

If you look at the otiipui from Is —1, you wtlJ see 
that there are nine white-space-separated fields. The file 
name is the ninth field, and if you wanted to sort the 
output into case-in dependent order using the old 
arguments to son, yoLi would say 

$ is -1 I sort -f +8 

You c:ould read this as ""use a sort key .starring after 
I he eigltih field and stopping at the end of the ninth field.” 
j.e., use the ninth field as the primary sort key. 
Alternatively, you could start counting the fields from 
zero, and arrive al number eight for the value, for die 
name field. You can chcnise htiw to think about the 
arguments; the effect is tlie same. 

Had we not given a stopping point for the field, 
then sort would use a sorting key commencing from 
the starting point, and terminating at the end of the 
fine. In the example above, the stopping posititin is not 
nec:essary. but fve included it for couipleicness. 

You can u.se the sort argument —k followed by a 
comma-separateti range. Also, it starts numbering the 
Helds fnnu one. so 

$ lij 1 I sort -f -k 9,9 

will Starr the field at the Ixrginiiing of the ninih field, and finish 
it at the end of tlie nintii fiekl *l1iis seems a little more intuitive, 

The question then aiiscs alxiut what hap[:>ens when the 
fields are identical. Tliis can happen naturally in other data 
sets and can still lae relevant w^hen kxiking al file names that 
aie guaranteed ro be ijnk|ue. For example, Fred is a 
different file fnim f red, but sort will treat the two names a.s 
the Siiiiie, when we are using the -f option. If you have 
selected a field and sort finds that tlie fields in two lines 
are the same, then the default follow-ujD action is to use the 
w^iole line as a sort key to order the two lines. 

Tlieie Lue obviously situations where dilTerent ibllow-up 
actions are needed, and sort supplies some hirtiier options, 
the firsi opiitin i.s to su]>[)ly file -u aigumeni. sy[>pressing 
rcctirds wdfii identical fields, which allows file sort command 
to lake on sc>me of the hinctionality tif tlie uniq ctxnmand. 

If you w'anl to see the replicated data, then the second 
option Is to apply the soit modifier just to the field, by putting 
tile magic control letter after the field specification, rather tlnin 
making it apply to all fields by placing it Ix^fore the -k on the 
CT)iTimand line. Wc can tiien provide several tliffereni sort 
criteria for diffetent fields and add multiple field selections; 

$14? ] I sort -k 9.9f -k 
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Mere, we ’^ill sort files into case-independent order Ijased 
on field nine, Tlien, if the names are the same, we will sort 
based on lleid six usin^ month name cximp^irison. The M 
modifier soils die field by lecognizing a diree-chaincter month 
name and sotting into month order. Of course, we atn go on 
adding fields lo make a lietter job of ,sorting on the dite in the 
Is output. Incidentally, the M modifier is not slindard POSIX. 

Field Separators 

Field sepanitors liave always Ixfen a prtjlilem for sort, and 
they don’t seem to Irive iDeen completely rationalized by 
POSIX. POSIX says dial in llie default cr^Lse, field sepanitons aie 
tieated as j^irt of die sort key. Tlierdbm, .sfxtces and tab 
c'ha meters that \^ill appear to the Siinie wliite space on die 
screen, will my.siehously sort into what appears to be a strange 
Older; llie folks wht.> wrote llie UNIX I^mKT Tools txxjk (see 
Mirdier Reading), came to the conclusion that in die default 
ease you always had one ^'tfee" blank chameter diat was not 
included as part of t!ic field. 1 susixtt dial you need to 
experiment with your implementation to find out what 
fiappens, if the .sepirator Ixhavior seems to lie causing 
problems. One jxxssilile liglu at Lite end of die sepamtor tunnel 
LS the -b option, which tells the sort command to Ibid 
multiple cx:c:uriences of the .seixinitor charaaer into one. *lhe 
general advice in difiiculi cases wfit^rc? tal^is and spaces are used 
for sepaiators Ls to replace all the tabs with spaces and use 

$ sort -t ■ ■ -b ... 


to ensme that separators are collapsed to a single 
character that is not regarded as part of any sorting field. 

If you need to specify byte insets into sorting fields, 
then this is possil>le widi a furdicr piece of syntax. An 
offset into a field is given by supplying a number after a 
period in the key definition field, so 

S sort -k 2.3b,2,3b 

will sort the data based on the third non-blank character of 
the secr)nd field. Ido suspect that 1 am now entering realms 
of the sort command that are rarely used, largely becau.se 
people don1 know that the ability to dc^ the job is available, 
and also beouse it seems hard to prove that the sorting 
you need is actually being done f>y the progium. 

Further Reading 

As I have mentioned, there's a whole section on soitiiig 
in UNIX Ibols by Jerry Peek, Tim O’Reilly, and Mike 

Loukides et al (f,s published by O’Reilly & As.s(K'iates (fSBN 
0-333-35402-7). 

_ ^ 
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monied la his mfe ive for 7 yms. He finds writing the author's fno the 
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One Mcmtjrial Drive 

Cambridge, MA 02142 

Sale^: 800-7‘>3'2571 

Main wei> .siic: www.tntersystems.com 

CACHE LS a mutiidimensif>nal database 
that unic|Liely tombines robust objects 
and robust SQL, tlius eliniinxiting object^ 
relational mapping. Cache enables rapid 
Web application devekjpmenL 
extraordinary tnmsaclion processing 
speed, massive scalability, and real-time 
ejueries against transactional data - with 
minimal maintenance requirements. 

See adwft^ment on fHige 27 of this issue. 

JCHS Media Pte Ltd. / 
Mobile Juice 

^7 Beach Road #04-04 
Kheng Chiu building, 189863 
Singapore 

Sales: (65) 63346618 

Main web site: www.jchsmedia.com 

Al JCHS Media Ptc Ltd, our mission is to 
be the leading provider of handheld 
Gear accessories which cater to a 
diverse range markets and customers. 
Our M<Hio is to Protect and care for our 
customers Handheld. 

See iid^'ertisemmt on page $4 of ihk issue. 

Kerio Technologies Inc. 

2350 Mission College lilvd. 

Suite 400 

Santa Clara, CA 95054 
Sales: 4<)8-49(>4500 
Main web site: wwwierio.CQtrt 

Designed for sniall and inediiini-sized 
businesses and organizations, Kerio 
MailServer is a messiiging and collalxMation 
server that manages email, sliaied 
calendars, licsks, and notes. It natively 
suppoas Microsoft Fjitourage and Mknxsofi 
CXitkxxk ft)r client actrss in addition to its 
feature-rich WebMail, tlius providing a 
viable alternative to Microsc^ Exchange. 

See admriisement on page 2 i of this issue. 


MacDirectory 

420 Lincoln Road 
Suite 374 

Miami Heach. FL 33139 

Sales: 617-542-3251 

Main weh site: www.macdirectory.com 

See adtierlisemeni on pc^e 75 of Ibis issue. 


MacResource Computers 
& Service 

1301 S. College Ave. 

Bryan, TX 77801 

Sales: l-«8«-MAC-lUi:SOURCE 

Main web site: www.mac-resoutcexom 

MacResource Computers is an authorized 
Apple Service Provider anti Value Added 
Reseller, and a Texas Qualified 
Inforinalion Systems Vendor We provide 
consulting, hardware and softw^are sales, 
service, and support for complete and 
customized Ai)ple and Apple-compatible 
solutions. 

See adm^rtisemerti on page 69 of this issue. 


MacSpeech, Inc. 

50A Northwestern Drive, Suite IlOA 

Salem. Nil 03079 

Sales: (603) 471-3585 

Main web site: www.macsDeech.com 

See adi'ertiscment on (Mge 30 of this issue. 


MacTech Magazine 

BO Box 5200 

Westlake Village. CA 91359 
Sales: 877-622-8324 

Main web site: www.mactech.com 

Established in 1984, Mac Lech Magazine is 
the only monthly magazine fexused on 
Macintosh tedint)k>gy. l)istri[>uted in over 
60 countries, MacTech is read by tens of 
thousands of technical Madmt>sh users 
from netwe^rk adminisirau>rs to 
prognimmcrs, from solution providers to 
Enterprise, and in gener^il anyone that's 
interested in getting under die hcxxl. 

See Mh.'ertisement on J)age 45.87 of tins mue. 


MARX CryptoTech LP 

Peachtree Commons Office Park 
4485 Tencli Rd. #310 
Suwanee, GA 50024 
Sales: +1 770-9044)369 
Main w'eb site: www.crvptotech.CQm 

The CRYP7'0-BOX USB is the ^‘short" 
answer to your questions aix)ut 
software protection under Windows, 
Mac OS or Linux. 

See adi>ert/sement on page 11 of this imie. 

Meta Communications 

1210 S, Gill-iert St. 

Iowa City, lA 52240 

Sales: (BOO) 771-6382 

Main weh site: wvwv.meta-CQmm.com 

Ininxlucing Workgroups™ 2006, a 
pnxess and prexiuctivity management 
suite for creative, publishing and 
prepress workgixnips. Workgroup.s 2006 
is engineeretl to he![) your workgroup 
take control and harness your workflow 
to achieve beiier results, faster, and with 
less eriV>ft. 

adieriisemeni on fHtge 77 of ibis mue. 

Metafy LLC 

I>0 Box .1 

Boulder, CO 80306 
Sales: 303-938-8850 

Main web site: www.metakcom 

Anthracite autojnaies extracting dam 
from iniernei .sourt'es, modifying it into 
difft:a:nl formats and exporting to 
tem[^lates or databases as part of your 
daily Wf>rkfl^w^ Sample u.ses include 
populating dalaixsses with internet data, 
generating RSS feeds from websites, 
making e-mail alerts from web cnntenL, 
and ciLstomized daily retxjrting, 

.V<?e adt*ertisement on fmge 2J of this issue. 
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In-terviews 


Tapping into the world of 
celebrities and their Macs, only 
MacDirectory offers exclusive 
interviews. Get a close and 
personal view from Sarah 
jessica Parker, Steve Jobs, 
Madonna, Harry Connick Jr., 
George Lucas, Jennifer Jason 
Leigh, Steve Woz and other 
leaders in the Mac community. 


Feat:ures 

Designers, writers, musicians, 
business leaders & our technical 
expert team offer their own 
personal interpretation of 
things that only the Mac system 
can deliver. With more than 
200 pages of news, insights, 
trends and the largest 
Macintosh buyer's guide 
including over 5,000 Mac 
products and services. 


Wr 


MacDirectory 

BEYOND ANY MACINTOSH MAfSAZiNE. ^ 



Cultiure 

MacDirectory takes you to the 
wildest corners of the world 
and uncovers how Macintosh 
computers are being used by 
other cultures. Travel to Japan, 
Australia, Germany. Brazil Bi 
Russia and learn more about 
AppI e’s cuitu ra! i m pact 
around the globe. 


Reviews 

Find out aif you need to 
know about the latest Mac 
products including the 
hottest Mac OS software 
and hardware. 




macdi rectory, com 


Send check or money order to: 
MacDirectory Subscription Dept, 
326 A Street, 2C 
Boston, MA 02210 





MicroReplay, Inc. 

309 Walnut Street 

Wellesk'v, MA 02481 

Main web site; www.niicroreplav.conn 

See (uliierlisetnml on page 4 of this issue. 

MOST Training and 
Consulting 

4541 N. Itavenswocd Ste. 202 
Chicago, II 60640 
Sales: 773-506-21(X) 

Main web site: www.niacwofkshops.com 

The Mac/Win HelpMatc fairnly of tCKjis 
coml:>ine5 diagnostic features wath scTeen 
sharing with a low subscription fee that 
coveiTi all the users you supporl. Secure 
screen sharing works tlirough firewalk 
with no port Forwarding or VPN setup. 
Software is branded for your company 
recluiring no admin account to share 
screen. 

See adim dsemerU on page 20 of this ijnsue. 

MYOB US, Inc. 

3<)0 Roundliill Drive 
Rockaway, NJ 07866 
Sales: 800-322-iVlY01i 
Main web site: www.myobxonn/us 

MYOB is a global provider of solutions 
that lilxfrate bu.siness owners and 
accountants from the liuixlen of day to 
day administration, emi^owering them to 
achieve business success. MYOB 
develops and delivers award-winning 
software, services and support for more 
than 500,0(10 busines-ses and over 10,000 
accounting practices worldwide. 

See at/mrSisemeni 07 i petge /J of tlm mne^ 

Netopia, Inc. 

2470 Mariner Square Loop 
Alameda, CA 94501 
Sales: (510) 420-7400 
Main web site: www.netopia.com 

Netopia, Inc. is a market leader and 
innovator in broadband customer 


premises equipment, remote managemcnl 
software, and broadband services. Netopia 
offers carrier-class wired and wireless 
modems, routers, and gateways. Netopia 
gateways serve markets from residential 
through enterprise-a'ale distributed 
businesses, and enable broadband access 
for voice, video, data, and oilier services. 
See adim-tisement on page IfC of this isstde. 


NetTeam Consuiting 

3015 Lake Drive 
Citywesi, Dublin 24 
Ireland 

Sales: (202) 250-3434 

Main web site: www.netteamconsultina.conn 

NetTeam Server offers people, task and 
dcKiiment management services for 
role/task liased work flows. 

See adtfertisemem on page 41 of this issue. 


Network Hardware 
Resale 

90 Castilian Drive, Suite 110 
Santa Barbara, CA 93117 
Sales: 800.451.3407 

Main web site: www.networkhafdware.com 

Network Hardware Resale (NHR) is the 
trusted, global resource for refurbished 
Cisco and used Cisco hardware including 
Cisco routers, sTvitches and more. NHR 
customers receive a great value on like- 
new cquipnieni tiackcd with an indLisiry- 
leading one-year warranty and support 
from Cisc’o-ceriified technicians. 

See admrfhement on page 65 of this Issue. 


Now Software 

670 Morrison Road, Suite 220 
Gahanna, OH 43230-532^^ 

Sales: 800-344-9160 

Main web site: www.nowsoftware.CQm 

Based in Columbus, Ohio, Now Software 
is the developer of the Eddy award¬ 
winning Now Up-to-Date & Contact. Now 
Hp-to-Date ik Conlaci is the #1 Calendar 


and ConiacL Management software for 
business and power users! Cross 
platform group meeting scheduling for 
both Macintosh and Windows, 

adiHirtisem ent on page 37 of this issue. 

OlympicControls Corp. 

1250 Crispin Drive 
Elgin, fL 60123 
Sales: 847-742-3566 
Main web site: www.occofpxom 
BookEndz specializes in providing 
Apple customers with products that will 
enhance their experience with Apple 
Laptop Computers. Our goal is to 
provide quality Docking Stations and 
other accessory products as quickly as 
pos.sible after Apple introduces new and 
updated lapiop computers. 

odDertisement (yn page 51 of this issue. 

Opera Software ASA 

Waklemar 'Ihrime-s Gate 98 
Oslo, NO^0175 
Norway 

Sales; +47 24 16 40 00 
Main web site: www.Qpera.com 

0[XTa is a pow'erful tool tliat gives you 
more options w'hen surfing the Web. li 
is fasLci; safer and easier lo use than 
your current browser. We designed 
Opera ro fir your life - whether you 
want lu have more fun, get more done 
or express yoLir style. 

See adt?eritsemerti on page 43 of this A.vwfi. 
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Connect People, 
Projects, and Workflow 



Workgroups 2006 

Process and Productivity Management Suite for 
Creative, Publishing & Prepress 


§1 Job Manager 4.0 

Financial Productivity Management 

# Virtual Ticket 7.0 

Project & Workflow Management 

Job Manager enables creatives and production 
workgroups to accurately create estimates and 
quotes, monitor job costs, quickly generate 
on-demand reporting and invoices, and share 
information with accounting systems. 

With Virtual Ticket you’ll bring together all the 
components of your work in a centralized tocation, 
including project briefs, job tickets, customer info, 
ail the associated document files, andmore. 

0 Approval Manager 1.0 

Collaborative Approval Management 

# Digital Storage Manager 2.0 
Document Storage Management 

Approval Manager masters the inherent difficulty 
of managing, tracking, and scheduling any proof 
approval process within and across creative and 
production environments. 

Digital Storage Manager is a powerful storage 
management solution specially designed to 
manage the thousands of digital document files 
during the creative and production process. 


AAeto Software Today! 

co-^iuiJefiTioNs vww.meta-comm.com • 1 (800) 771-6382 

M?laCcmrriun(cattorv5rVVb'%pups. 200@, Job Manaesf, ViraalTIcIrat, AppiovaF Marisgej, and Digitfll Siorafla Msftae^raie of MetaCommisnicatiorte, Inc- Atl rasarvett. 

Additional company and product nBiiies may ba tjadamafks or nglEteied pademartts of tfia individual coflipanEed aro re^fidctfuliy acMroft1&i:J£ed. and licansing^uDj^ct to widioul nnttee. 




Other World 
Computing 

1004 Courtaulds Drive 

Woodstock, IL 60098 

Snle.s: 800-2754576 

Main well site: www.owcomputingxom 

Other World Computing (OWC) is a 
laiding supplier of support prtxJucLs 
and upgrades lo keep old Macs ainning 
like new and to jmxiiiilze the potential 
of the latest models. Through 
WWW. MacSales.com OWC olTcrs 
memory upgrades, processor upgrades, 
hardware and software, laptop batteries, 
iPtKl accessories, and external liard 
drive storage st)luiioas. 

Sec adt^Ikemeni on fjagc 7 , 25 of this issue. 

Ovolab 

Via Gari[)aldi 5 
Torino, 10122 
Italy 

Sa les : i nf {) ifitc wc>laI ), CO m 
Main web site: WWW.OVolabxorTi 

Ov’olab Phlink turns your Mac into a 
(X)werful answering maclune and 
telephone infonnation center. Widely 
used in the home, home offite and in 
businesses, it greets callers with 
personalized greetings, plays caller- 
specific ringtones, forwards voicemail 
messages by email, logs incoming and 
outgoing c'alls, and much nK>re. 

See (tdffertisefnenl on pn^e 9 of this issue. 


Protective Solutions Inc. 

M28 S. 2520 E. 

Salt Lake City. UT 84121 
Sales; 888.940.ZONK (9663) 

Main web site: www.theinvisibleshield.CQm 

Where once c^ses were the norm for 
protecting your device, the 
invisibleSHIELD full-lKxly wraps have 
Income the ultimate choice. Where once 
flimsy, disposable, screen protectors 
offcred only minimal coverage, now just 
one invisibleSHIELD offers a lifetime of 
protection. 

See udifertisement on page 35 of this 

RadTech, LLC 

4352 Rider 'frail Nonh 
Earth City, MO 63045 
Sales: +1 3M-2()9'9993 
Main web site: www.radtedl.us 

RatITech designs, nianulactures and OEM's 
innovative, high-tech accessories for the 
digitally aware. Our solutions are praciical, 
durable, mggedly built, fumtional at 
envirunmcntal extremes and lighlw'eight. 
See adtHfrUsement on page 22 of this issue 

SANYO Fisher Company 

21605 PliiitimtT Street 

Chatsworlli. CA 91311 

Safes: 14188-754-9500 

Main wch site: www.sanyo.com 

See adtvrtisemeni tm jmge 49 nf Ibis issue. 


Peachpit Press 


1249 Eightli Sueet 
Berkeley, CA 94710 


Salc.s: 800-283-9444 
Main wel> site:; 

Peaclipit has Ix^en publishing top-notch 
lxx>ks on the latest in graphic design, 
desktop publishing, multimedia, Web 
publishing, and general computing since 


1986. 


See adtferiiserfietn on page 79 of this issue. 


Seapine Software, Inc. 

5412 Counieview Dr., Suite 200 
Mason, OH 45040 
Sales: (888) 683^56 
Main web site: www.seapine.com 

TestTnic'k TCM Ls a QA suluLit)n for 
nianiiging all lacets of the software testing 
process including test case creation, 
scheduling, execution, measuremenL, and 
reptating. TestTrack TCM integrates with 
the leading isstie irumagement solution, 
'fesrTnick Pn.), to autonuKe ilie plan->test- 
>fix cycle. Complete suppoil for 
managing automated testing processes is 
also included. 

See adi'erdsement on page 29 of this issue. 

Spiderworks 

2534 North Jefferson Street 
Arlington, VA 22207 
Sa I es: St I ppt )rt ©spidc rwc jrks.coi n 
Main wei> site: www.5prderwork5.com 
SpiderWorks, LLC specializes in 
technology-relaied elkjtjks and printed 
books, providing cjuaiity content from 
respected autliors at a low price. 

See adiH*riisenwni on /Hige 67 of this issue. 

Spymac Network, Inc. 

350 - 5 Ave., Suite 3304 
New York, NY 10118 
Sales: 866-577-9622 
Main web site: www.spymaccom 

Spymac CJub is c'otriplctely 
advertisement-free, making your 
browsing ex]x*rience faster and cleaner 
Enjf)y browsing any Spymac pages, along 
with your liomepage and blog, ad-free! 
adirrtmnnent on page 15 of this issue. 
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CET Up AND 

RUNNING Quickly! 





For more than 15 years* the practical approach to the best-selling Visual QukkStart 
Guide series from Peachpit Press has helped millions of readers—from developers to 
designers to systems administrators and more—get up to speed on all sorts of computer 
programs. Now with select titles in full color, Visual QukkStart Guide books provide 
an even easier and more enjoyable way for readers to learn about new technology 
through task-based instruction, friendly prose, and visual explanations. 


Task-Based 

Information is broken down into 
concise, one- and two-page tasks 
to help you get right to work. 


Visual 

Hundreds of screen shots 
illustrate the steps and show 
you the best way to do them. 


Step by Step 

Numbered, easy-to-follow 
instructions guide you 
through each task. 



NAME THE VISUAL QUICKSTART CUIPE BUNNY! 



In the spirit of Peachpit's 20th anniversary, and the 15th 
anniversary of the classic Visual QuickStart Guide series, we 
are asking for your help to name the bunny. For contest 
details and a chance to win an 80GB iPod®, please visit; 

www.peachpit.com/namethebunny ^ 


















































SubRosaSoft.com, Ltd. 

4-15 Stale Highway 30 

Like Ronlunia, Rl)4 

Rotonia 3221, Bay of Plenty 

New Zealand 

Sales: (510) 675-0()Hl 

Main web site: www.subrQsasQft.com 

SiibRosaSoft specialized in privacy 

related and system utilities. 

SubKosjiSoft's design philosophy 
revolves around easy-to-use yet 
extremely powerful software. Our 
software range includes security, file 
and devitx^ management, home security, 
forensics, and data and device recoverve 
Our users range from entry-level Mat- 
users and iKjbbyjsts to sy.siem 
administrators, consultanLs, and forensics 
professionals. 

Setr on page / of (hi$ issue- 

Trango Broadband 
Wireless 

9939 Via Pasar 
San Diego, CA 92126 
Sales: 858-653-39(X) 

Main web site: www.trangobroBdband.CQm 
Trango is the only end-to-end 
manul'acturer 10{XH> dedicated to fixed 
broadband wireless pixKlucts in the 
world“products used in over 70 
countries Lo wirelessly conned 
consuinei's, businesses and government 
agencies needing high-.speed data 
iransmission for internet access, private 
networks or suiveillance applications. 

See admiisemetti on ftage of ihis issae. 

Tropical Software, Inc. 

246 Myra Street 

Neptune Beach, t-1 32266 

Sales: 888^876-7424 

Phone2: 904-249-4292 

Main web site: http://www.tropic4.com 

'IbpXNotes is a note pad replacemeni 

with multiple views, insUmt access tt) key 

infonnation, iPtxl integration and more. 

See adiH^iisement on page 6? of this issue. 


Underwriters 

Technologies 

4255 8 Charleston Blvd. 

Las Vegas, NV 89104-6640 
Sales: (877) 523-7150 
Main web site: www.uwtech.CQm 

Out of the box, Mac minis are very 
aipable and very easy to use. They are 
aide to serve mail, websites, databases, 
files, etc. We provide a high speed, high 
security lot'aticin to host your Mac mini at 
a low price poinL 

See adteriisetiwni on page 14 of titis issne. 


Utiiities4Less.com 

1652 Cro.ss Bridge Place 
Thousand Oaks. CA 91362 
Sales: (800) 906-8686 
Main web site: WWW.util itiesAlessxom 
Utilities41jes,s offers its clients a full range 
of communications services. L'iilities4Less 
is commiiiecl to offering ihe l>esl producus 
available at the lowe.st |KJssible prices. 

See adifertisement on page 68 of this issue. 


VersionTracker 

55 SW Yamhill .St. 

Portland, OR 9720-i 

Main web site: www.techtracker.com 
Version’! racktT Pro gives sulm ril>ers a 
powerful 1<M>1 lo update and inventory all 
their applications and drivers 
automatically, helping them keep rheir 
software currenl and secure. 
VersionTracker Pro provides cusiomized 
information by creating machine-specific 
tracking lists, acces.sible liirough a Web 
browser or auitjuiatically distributed 
directly to the user's de.sktop. 

See advertisemeul on page 62 of ibis issue. 


WiBU-SYSTEMS AG 

Rue|>purrLT Strasse 52-54 

Kari-snihe. D-76137 

Germany 

Sales: +49-721-93172-0 
Main web site: www.wibode 
WIBU specializes in developing software 
protection and additional solulions to 


protect documents, access and media. 
Tfie permanent increasing customer 
base is enthusiastic about the versatile 
products. WiBU-KEY, CodeMeter, 

Smart Shelter and SecuriKey. 

See adiKTtisetnent on page S3 of Ibis issue. 

Windows IT Pro 

A Division of Penton Media Inc. 

221 E. 29tli St 
Loveland, CO 8(1538 
Sales: (800) 62M544 
Main web site: www.windowsitpro.com 
The Windows IT Pro magazine netwTjrk- 
-which includes Windows IT Pro 
magazine, SQL Scrv'cr Magazine, 
Exchange Administrator, Windows 11’ 
Security, and Windows Scripting 
Solutions-is the leading inde|>endent, 
impartial source of practical, technical 
information to help ff professionals 
l>etTer understand and manage the 
Windows and SQL Serv'er enterprise. 

See admrtisemeni on page 73 of this issue. 

WorldSync, Inc. 

2039 Shatuick Avenue, Suite 302 
lierkelcy, CA 91704 
Sales: 1-877-5484920 
Main web .site: www.svncdek.CQm 

Typically, database replication and 
.synchnmiz.;ition retgiire aunplex 
administration, high-end servers and 
exj'jeasive live communications. 
SyncDeKd M) brings r()biist replication 
and synchronization to a nitich broader 
audience within the I’ileMaker 
community, SynGleK (offers 'replication 
to the rest of us." 

See advertisenient on page 52 of this issue. 
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Receive your faxes directfy to your email account 
as PDF file attachments 

Service available in over 150 area codes 


www.MaxEmail.com/MacTech 



pecial offers 
readers, visit 
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Accessories 

BetferltAAicom: RAM and Memcy, See page . $5^ 


J(HS Media Fte Ltd./Mobik Juke: 

Mobile Juke, See page *.... 54. 

MocSpeedi, Inc: iUsfen, See page. . 30. 

OlympkControk (orp .; BookEmtz, See page _ 5J. 

Other World Compifting ; Mar and IFod upgrades, 
memory, externahtorage solutions, hard drives, and 

accessories, See page ___ 7,25. 

Protective Solutions Inc.: 

Screen Protec^n, See page ... 35. 

Radlech, LLC: Rodfecb, See page. ..,,,,.22. 

Books and Publications 

MacDirectory: MacDirectory, See page . ,,75. 

MacTech Magazine: MacJecb Magazine, See page . B7, 
MacJecb Magazine: MacJecb (0, See page. .,..,.45, 
Peachpit Press: Peachpit Press, See page ........79. 

Spidef¥forks:SpiderWorksebooks, Seepage .....67. 

Windows U Pro: tJOndows U Pro, See page . .73. 

Business Services 

Brad Sniderman: bw Oibces, See page ........66. 

Brian Loomis: Hosted Store, See page . ,34. 

Cfitkal Path Software, Inc.: Oevehpment Services, 

See page. .. ... //. 

Allume: Aguazone Seven Seas Deluxe, 

Seepage ....... 

ICC, Inc, / MaxEMoiLcom: maxemaiLcom, 

Seepage... ... 81 

MacDirectory: MacDirectory, See page . ....75. 

MacResovrce Computers & Servke : 

MacResource Computers, See page............. 69. 

MkroReplay, Inc : MkroReptay, See page ^__ 4. 

Utilit'tes4Less.(om: Long Distance Phone Setvke, 

See page. . 68. 

Business Software 

MYOB US, Inc.: AceountEdge, See page _____ / J. 

NetTeam Consulting: Hetleam Server, See page. .,41 

Now Software: How Up-tchDate, See page _ ..,37. 

Jropkal Software, Inc. See page .. ....65. 

Communications, VoIP 

MacSpeech, tnc.: iUsten, See page . ....,30. 

Netopia, Inc.: Jimhuktu, See page . IFC. 

Ovotab: Pblink, See page . 9. 

tltilitie54Less.com: Long Distance Phone Servke, 

See page . 68. 


Copy Protection and Security 


Aladdin Knowledge Systems, tnc.: HASP, 

Seepage ___ .........2. 

Allume Systems, Inc.: Stuff It, See page . BC 

Intego, tnc: VirusBarrier See page ... 19. 

MARX CryptoTecb LP: CRYPTO-BOX, 

See page. ....*, ...//, 

OlympkControk Corp.: BookEndz, See page SL 
Wm^SYSlEMS AG: Security and Protection, 

Seepage. . ,,..,53. 

CPUs and Upgrades 

BettcrRAM.com: RAM and Memory, See page . ,85. 

MacRescrurce Com0ers 8 Service: 

MacResource Computers, See page. . ..,69^ 

Other World Computing: Mac and iPod upgrades, memory, 
external storage solutions, hard drives, 

and accessaries. See page . 7,25. 

Radlech, UC: Radlech, See page . ..22 

Databases 

Garrison Computer Services: fmSQL Synch, 

See page. . 50. 

Idea Storage Networks LLC: Seefile, See page . 61 

Inte^ystems Corporation: Cache, See page. . 27, 

HetJeam Consulting: NetJeam Server, See page 41. 
How Software: Now Up-tChDate, See page ...,,....37. 
WoridSync, Inc: SyncD^, See page . . 52. 

Developer Tools 

Aladdin Knowledge Systems, Inc.: HASP, 

See page ... ,2. 

Bdnig and Kallenbach oHG: SERVICE USB, 

See page.. . 28. 

Garrhan Computer Servkes: JmSQL Synch, 

Seepage . .......50. 

Intel Corporation: Intel (ornpder, Seepc^,... _ 5S,IBC 

tnterSystems (orporation: Cache, See page . . .27. 

MARX CrypioJech LP: CRYPTO-BOX, Seepage....,., 17. 
Metafy LLC: Anthracite Web Mining 

Desktop Toolkit, See page, .*__ 23, 

MOST Training and Consulting: Mac HelpMute / 

Mac UserMafe / Win HelpMate, See poge . 20. 

NetTeam Consulting: HelJeam Server, 

See page . . ........41. 

OperaSoHware ASA:Opera 9, 5ee page ... _ 43. 

Seapine Software, Inc.: TestTrack JCM, 

See page. . .......29. 

WIBU-SYSTEMS AG: Security and Protection, 

See page . 53. 

WoridSync, Inc: SyncDek, See page . 52, 


Development Services 

Automated WorkHows, LiC: Smpfing Sedations, 

Seepage ....... 60. 

Cfitkal Path Software, tnc.: Development Services, 

See page ......... 7L 


Displays and Monitors 

Other World Computing: Mac and iPod upgrades. 


memory, external storage safutions, bard drives, 
and occessories, See page . 7,25. 

Enterprise 

AMCC: 3ware Sidecar, See page .. 31. 

IGC, Inc /MaxEMaiUom: maxemaiLcom, 

Seepage _ 81 

tntego, Inc: YirusBarfier, See poge . . 19. 

tnierSystems Corporation: Cache, See page ......27. 

Kerb Technolagies Inc.: Kerio Server Software, 

Seepage . . 21. 

Meta CommunkaUons: Digital Storage Manager, 

Seepage .. ............77, 

MOSf Training and Consulting: Mac HelpMate / 

Mac UserMate / VCia HelpMate, See page _ 20. 

Netopia, inc.: Ftmtuktu, See poge _ __ IfC 

NetJeam Consulting: NetTeam Server, See page ... 41 

Now Software: Now Up-to-Oute, See page . 37. 

Trongo Broadband Wireless: Trango Broadband, 

Seepc^ . ^.83. 

WIBU SYSTEMS AG: Secarity and Protection, 

Seepage .. 53. 

Windows IT Pro : Windows IT Pro, See page ... _ 73. 

Home Automation 

Mac^seech, tnc.:ilhten. Seepa^ . 30. 

Ovolab: Phfink, See page .... 9. 

Internet Services 

Brian Loomb: Hosted Store, See page _ .....34. 

IOC, tnc /MaxEMaif com: maxemaiLcom, 

See poge ... 8!. 

Spymac Network, Inc: Spymac, See poge ....... 15. 

Underwriters Technologies: Moc k^ni Co4o, 

See page _________ 14. 

Utitifies4Less.com: Long Dbtance Phone Service, 


Seepage ...... 68. 

iPod 

JCHS Media Pte Lid. /Motile Juice: MobUe Juke, 


Seepage .. ..54. 

Protective Salufions Inc.: Screerf Protection, 

Seepage . 35. 

Jropkal Software, Inc See page ... 65. 
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_solutions 

from Trango... 

ATLAS 5010 Serles"“ 

Wireless Ethernet Bridge 

» 45 Mbps of sustained throughput 


Nobody beats us on... 

Price 

Save thousands on 
multi-location T1 services 

I|b Performance 

6 to 30x faster than TT service 

Reliability 

Best-in-class fixed wireless solutions 


» Capable of 5.3 and 5.8 GHz 


» Point-to-point, OFDM 
» Up to 40-mile range 
» Adaptable Rate Modulation 




Wireless Connectivity ® Powered by Trango 


Trango Broadband Wireless | www.trangobroadband.com 

A division of Trango Systems. Inc. | Phone: +1 (858) 653-3900 


trangobroadband* 

W / I? E L £ S S 







Mac OS X Migration Services 

Critical Path Software, he. : De¥elopmeat Sermei, 

See page __ 


Mail Order/Retailer 

BettefRAM.com: RAM and Memory, See page ,...85, 
MocResource Computers & Seryke: 

MacResoarce Computers, See page ... — 69. 

Network Hardware Resale: Gseo Hardware, 

Seepage .... 65. 

Other World Computing: Mac and iPod upgrades, 
memory, external storage solutions, hard drives, 

and accessories, See page ... 7,25. 

RadTech, LLC: Radlech, See page ....... _ 22. 

Multimedia, Graphics 

equilibrium : OeBabeliier, See page ............26. 

Idea Storage Networks LLC: Seefik, See page _ 61. 

Meta Communkations: Digital Storage Manager, 

See page ....... ...77. 

Networking 

AMCC: Swore Sidecar, See page .. 3L 

GleWave (USA), Inc.: RhWave, See page .......63. 

Kerio Technologies tnc.: Kerio Server Software, 

See page ..* —. 21. 

MocResource Computers & Service: MocResource 

Computers, See page .... ..69. 

MOST Training and Consulting: Mac HelpMafe / 

Mac UserMate / Win HelpMate, See page . 20. 

Netopia, Inc.: rmbuktu. See page . 

Network Hardware Resale: Osco Hardware, 

See page . ... ....... 65. 

Irongo Broadband Wireless : Trango Broadband, 

See page ... B3. 

Underwriters Technologies: Mac Mini Co-h, 


See page ..*.. .14. 

Operating Systems 

MOST Training and Consulting: Mac HelpMote/ 


Mac UserMate / Win HelpMate, Seepage . 20. 

Peripherals 

AMCC: Swore Sidecar, See page. . ...31. 

Bonig und Kallenbach oH6: SERVICE USB, 

See page . ...28. 

MocResource Computers S Service: 

MocResource Computers, Seepage . 69. 

Network Hardware Resole: Gsco Hardware, 

Seepage . . 65 

OfympkControlsCarp.:BookEndi Seepage ...... 5T 

RadTech UC. RodTech, Seepage _ ........22 


Productivity 

Allume Systems, Inc.: Sfufflf, See page . BC 

fguilibrium: DeBaietzer, See page . . ...26. 

f&Hfevfl (USA), Inc.: RkWave, See page . 63. 

Oarrison Computer Servkes: fmSQl Syndt, 

Seepage . . ........50. 

Idea Storage Networks tlC: SeeSk, See page _ 6T. 

IGC Inc. /MaxEMoil.com: maxmail.com, 

Seepage . . SI. 

Xerio Technologies Inc.: Kerio Server Software, 

Seepage . . ...2T 

MacSpeech, Inc.:iUsten, Seepc^e . ..30. 

Meta Communications : Digital Storage Manager, 

See page . . 77. 

Metafy Lie: Anthracite Web Mining Desktop 

Toolkit, See page . 23. 

MYOBUS, Inc.:Accountfdge, Seepage . . 13 

Now Software: Now Up'toDate, See page .......37. 

Opera Software ASA i Opera 9, Seepage_ _* *. -#1 

Seapine Software, Inc: TestTradc TCM, See page ...29. 
SubRosaSoft.cm, Ud .; CopyCat)C^kSalvage, 

Seepage ......... ..*. .....1. 

Tropkal Software, tnc See page .. _. ^J. 

WorldSyac, Inc : SyncDek, See page . ..52. 

Scripting 

Autmated Workflows, IlC: Scripting Solutions, 

See page ............... 60. 

Metafy ttC: Anthracite Web Mining Desktop 

Toolkit, See page .... —.... 23. 

Ovoiab: Phlink, See page . ... 9. 

Server Software 

Brian Loomis: Hosted Store, See page . .....34. 

Equilibrium: DeBobelizer, See page ... 26. 

EileWave (USA), Inc.: FileWove, S^page . 

Idea Storage Networks IlC: Seefik See page . 61. 

Intego, Inc.: VkusBarrier, Seepage . 19. 

InterSystems Corpora/ion . Cache, See page. . 27. 

Kerio Technologies Inc.: Kerio Server Software, 

See page ...... ..21. 

Meta Communkations: Dig/tai Storage Manager, 

See page . 77. 

NetTeom Consulting: NctTeam Server, See page ... 41 
Now Software: Now Up-to-Date, See page .......37. 

Seapine Software, Inc.: TestJrock TCM, See page ...29. 
WorldSync, Inc: SyncDek, See page . . .....52 

Storage 

Allume Sptems, Inc. :Slufflt See page .......... BC 

AMCC: Swore Sidecar, Seepage . . .31 

BetterRAM.cm: RAM and Memory, See page _ .85. 

Equilibrium: DeBobelizer, See page ... 26. 

Other World Computing: Mac and iPod upgrades, memory, 
external storage sedutions, hard drives, and accessories, 

Seepage . ....7,25. 

SubRosaSoft.cm, Ltd .: CopyCatX/RleSalvage, 

See page .... 


Trade Show/Conference 

iDG World Expo Corporatm : Macworld Expo, 

See page . ..... 57. 

Training Related 

Automated Workfhm, U.C: Scripting Solutions, 

See page . ...... 60. 

MacTech Maganno : Moclech Magazina, See page . 87. 


MacTech Magazine: MaeJeeb CD, See page. . .45. 

Peachpit Press: Peachpit Press, See page .. 79. 

Spiderworks: SpiderWorks ebooks, See page . 67. 

Utilities 

Aladdin Knowledge Systems, Inc: HASP, 

Seepage ... ...2. 

Allume Systems, Inc.: Stufftt, See page . BC 

Biinig and Kallenbach oHG: SERYKE USB, 

Seepage. . 28. 

EileWave (USA), Inc.: FileWove, Seepage . 63. 

Intego, tnc.: YirusBorrier, See page .. 19. 

Kerio Technologies Inc.: Kerio Server Software, 

Seepage ... 21. 

MARX CryptoTech If: CRYPTO-BOX, Seepage.... 17. 
MOST Training and Consulting: Mac HelpMate / 

Mac UserMate / Win HelpMate, See page . 7,25 

Netopk Inc *' Timbuktu, See page . IfC. 

Opera Software ASA: Opera 9, See page _ _ ..43. 

Ovoiab: Phiink, See page .... 9. 

SubRosaSoft.com, Ltd. t CopyCntX/EdeSalva^, 

See page_ _...---- ..L 

WorldSync, Inc.: SyncDek, See page —. 52 
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Is your computer running up hill? 

Maybe it could use some help. 



com 


sm 


Name brand quaUty. Value pricing. Ufetime guarantee. World c/ass support. 



Run up those hills, 

PI 

get better ram. 
















(alphabetical order) 

Svmre Sidmf, See odon page .. ....... J/ 

AccounfEdgs, See ad en page ..*. ..,.13 

Anthracite Web Mining Oesktop Toolkit, See od on page „, _ „ ... 23 

Aquaione Seven Seas Deluxe, See ad on page .*. U 

BookEndz, See ad on page _______ SI 

Cache, See od on page . ..... 27 

Gsco Hardware, See ad on page .......... 65 

CopyCatX/rdeSalvage, See ad on page ...... / 

CHYFIO-BOX, See ad on page .... // 

DeBabelizer, See ad on page ........ 26 

Development Services, See ad on page .. 71 

Digital Storage Manager, See ad on page. .....77 

fileWave, See ad on page .... 63 

fmSQL Speh, See ad an page ..... 50 

HASP, See od on page .....^ 7 

HD Video Camera, See ad on page ......... 49 

Hosted Store, See ad on page ...... ..34 

iUsfen, See ad on page ... 30 

Intel Compiler, See ad on page ....... .55 

Internet Cleanup 4, See ad on page ... . 59 

Kerio Server Software, See ad on page ... 21 

Law Offices, See ad on page . ... 66 

long Distance Phone Service, See ad an page .. 68 

Mac and iPod upgrades, memory, external storage solutions, 

bard drives, and accessories, See ad an page ..... 7,25 

Mac HelpMate / Mac UserMate / Win HelpMate, See ad on page ... 20 

Mac Mini Co-lo, See od on page _......... 14 

MacDirectory, See od on page .... . 7S 

MacResource Computers, See ad on page ........ ___.... 69 


Madeeb CD, See od on page. ....... 45 

MaeJedi Magazine, See ad on page ...... B7 

Macworld Expo, See ad on pnge ......... 57 

maxemail.com, See ad on page . ....... . 81 

MicroReplay, See ad on page . ..... 

Mobile Juke, See ad on page .... . 54 

Hefleam Server, See ad en page ..... 41 

How Dp-to-Dofe, See ad on page ... 37 

Opera 9, See ad on page ..... ..,..43 

Peachpit Press, See ad on page ...... 79 

f4}linl(, See ad on page.. ........ 9 

RadTech, See ad on page .... .22 

RAM and Memory, See ad on page ... .....85 

Screen Protection, See ad on page .. 35 

Scripting Solutions, See ad on page. .. . 60 

Security and Protection, See ad on page .... 53 

Seehle, See ad on page ....... ....61 

SERVICE USB, See ad on page ..... 28 

SpiderWofh ebooks. See ad on page. .......... 67 

Spyum, See ad an page ...... IS 

Staffit, See ad on page. .... BC 

SyncDek, See ad on page ..... S2 

Jest Track Pro, See ad on page ........ 29 

Jimbukta, See ad on page . ............ IK 

Irango Broadband, See ad on page.. .... ,....83 

Tropical Software, Inc. See ad an page ... .....65, 

VersionTrackef Fro, See ad on page. ..... 62 

VirusBarrier, See ad on page. .... 19 

Vfmdows IT Pro, See ad on page. ..... 73 


86 December • 2006 


WWW.MACTECH.COM 




































































Does 




= questions? 


Are you routinely looking for answers? 

Imagine a whole year of answers. 

MacTech Magazine is already read every month by 
tens of thousands of readers. Readers that represent 
the very heart and soul of the Mac community. Join 
the crowd and sign up today! 

For a special one year 
subscription, visit: 

store.mactech .com 

Toll Free 877-MACTECH. Outside US/Canada: 805-494-9797 
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Translate Macintosh* MultiCore 
Power into Application Performance 



Get your applications ready for parallel and scalable processing 


Right the first time: 

Inter C++ Compiler for Mac OS* is a highly optimized compiler 
designed to handle the most demanding applications. Intel augments 
these compilers with advanced support for threading through OpenMP* 
and auto-parallelism capabilities. 

Intel* Fortran Compiler for Mac OS* provides a fast and easy way 
to get maximum application performance for compute intensive applications. 
This compiler supports OpenMP* and auto-parallelism to take advantage of 
performance features available in the Multi-Core Intel* Processors. 

Intel* Math Kernel Library for Mac OS* is a set of highly optimized, 
thread-safe, mathematical functions that reduces the need for hand-coding 
and allows developers to achieve outstanding performance for engineering, 
scientific and financial applications. 

Intel’ Integrated Performance Primitives for Mac OS* enable software 
developers to achieve maximum application performance and reduce 
development time. They provide highly optimized functions for math, graphics, 
multimedia, audio, video, speech, computer vision, image, cryptography and 
signal processing that have been heavily optimized for Intel* processors. 


. 

"IVeVe been an Intel C++ compiler customer and are 
impressed with the results. We are encouraged by Intel's 
commitment to expand their software development tools 
to support the exciting new Intel-based Mac platform." 

Kevin Tureski—Director of Engineering, Maya, Mas Systems 

_ _ J 




( 

* 2006 Intel CoiporallPh, Intel, the Intel PentSuntj itanEym^ Intel Xuon 
and ottief cotjntrles. * Other names and brands maybe claimed as the property 


Custom Solutions 
888.414.5846 

http://www.cs-software.com/intel 

Programmer's Paradise 
800.443.9990 

http://WWW. program mers.com/j ntel 
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